home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-13
/
ee452.zip
/
EASYMAN.TXT
< prev
next >
Wrap
Text File
|
1991-08-13
|
239KB
|
5,405 lines
@op
EASYEDIT II
User Manual
V4.5
(C) 1986-1991 The AsEditCo
Warren Cottage
Warren Lane
Elmswell
Suffolk
IP30 9DT
England
Tel: 0359 41601
@pa
@pg
@tc0Introduction
Introduction
------------
What is EasyEdit ?
1. EasyEdit is a text editor. This means that it can create readable
text files using just the normal ASCII character set. Unlike
full-blown word processors, files created or amended with EasyEdit
can be read directly by DOS (the TYPE command) or by most other
text readers and word processors.
2. EasyEdit is a word processor. It has many of the features of more
powerful word processors but without a lot of the overheads. The
list of what it can do is almost endless.
3. EasyEdit is easy to use. It has been designed so that anyone can
install it and use it with a minimum of fuss. Of course, you can
customise it to your own personal preferences.
4. EasyEdit runs on IBM PC/XT/AT computers and all true compatibles.
It has been tested under DOS V3.3 but should work on all versions
greater that 3.0. It requires about 256Kb of memory but will use up
to 640Kb. It will only edit files 'in memory' and does not spool to
disk so there is a finite limit on file size. This was done
deliberately for SPEED.
@tc1Features
Features
--------
Well, where do you start ?
Editing
Full customisable mouse support (Microsoft mouse compatible)
Read in Read-only files.
Works on most networks - tested in Digital Equipment's PCSA
environment and Novell Netware.
Will lock files in a network or multi-tasking environment.
Pulldown, popup user replaceable menu system.
Built in spell checker with over 80,000 words.
Windows:
Can edit up to 6 files at once or the same file 6 times.
Specify wild cards as a filename and search for the correct file.
Cut and paste between windows or within windows.
Zoom or shrink windows.
Printing:
Print files from within EasyEdit and continue editing (background
printing).
Use print enhancements such as bold, superscript etc
Customisable printer definition tables, character translation
tables and font file tables.
Print to a file or any DOS device (LPT1-3, COM1-2).
Print to a network printer.
Automatic or manual pagination commands
Headers and footers with page numbering and date/time stamping.
Window display of print status on demand.
Print Table of Contents with many formatting options
@pa
On-screen formatting:
Centreing.
Paragraph or block formatting
Temporary margins
Right Justification
Case changes
Search
Find text - case sensitive or not
Globally or within a block
Whole word search
Search forwards or backwards
Find the nth occurrence of text.
Include control characters in search
Find next
Find and replace
Find text and then execute a macro
Search for text before/after/between or at columns
Block
Mark blocks.
Copy, move, delete blocks.
Read or write blocks.
Work in Line mode or Column mode.
Tabs
Set tabs to any fixed size
Set tabs anywhere
Set 'smart tabs' to match the current line of text
Turn tab display off
Expand tabs to spaces on loading or saving
Turn auto-indent on or off
Display
Get 43 line display on EGA systems
Get 50 line display on VGA systems
Modify colours of all parts of the display. Save them to a colour
file for later use.
Line or block cursor (useful for LCD displays).
Margins
Set left, right, top and bottom margins
Set page length.
Data saved with each file (but not IN the file).
Macros
Load, save or edit macros
Enter macros as you are typing
Include macro substitution.
Context sensitive help.
Over 200 pages of help available at the press of a button
@pa
Can be used as a TSR - either swapping for maximum free memory, or as
resident program for speedy response (registered version only)
Configuration file for editing defaults and mouse commands. Options
can be made environment variables
Abbreviations expansion from user configurable files.
Perform DOS commands while still editing.
Edit last file you were editing + go to last edited row and column
Undelete lines or blocks of text
Automatic backups while editing - user configurable
Automatically load and run macros on entry if required.
Uses overlays for maximum free memory
Can import and export binary files for transport via a mail system.
Can find matching 'begin/end' or other programming pairs.
Can swap out to your favourite compiler and return displaying any
error lines.
Keyboard
Has 'Wordstar' like commands built in as default.
Has predefined usage of function keys.
All function, control and Alt keys fully customisable using the
keyboard installation program. Can utilise the extra features of
an Enhanced keyboard.
..................and much much more...................
@pa
@tc0The Shareware concept
The Shareware concept.
----------------------
EasyEdit II is a shareware product if you received a copy either
from a friend or from any network or bulletin board (or indeed if
you obtained a copy in any other 'free' way).
What this means is that I grant you a license to try it out for a
limited period of ONE MONTH . After that, I expect you to register
with me and pay a license fee for its continued use. In return, I
will send you the latest update plus the professional manual. With
this update, you will get the additional functionality of being
able to let EasyEdit stay as a TSR program and the spell checker.
After the free upgrade, you may register for maintenance upgrades
at the basic registration price. This will entitle you to the next
major upgrade. A major upgrade is where the version number changes
its 'tenths' number. (eg 1.74 to 1.80). You may also wish to
suggest ideas to incorporate into future versions of EasyEdit. If
your idea is accepted, you will be given a free upgrade which
includes that suggestion.
After registration, you may use EasyEdit II on as many computers
as you wish, as long as you own them or use them on a regular
basis. Companies, please see below for site or company licenses.
If you no longer wish to use the software, please destroy ALL
copies, including any backups you may have made.
If you wish to give the software away, you may do so as long as
you give it away in its entirety. This means all the programs,
manuals and supporting files. The onus is then on the receiver to
abide by the terms of the registration. This, of course, does NOT
apply to the registered version.
@pa
@tc1Prices
Prices
------
Individuals
-----------
The cost is £35.00 sterling (sorry, I can't accept foreign
currency) and the address to send it to is at the front of this
manual. This is for basic registration and entitles you to a copy
of the professional manual plus the version of EasyEdit which will
stay resident as a TSR program. You also get the 80,000 word
dictionary.
The advanced registration costs £45.00 and entitles you to a
printed copy of the professional manual plus one free upgrade as
it becomes available.
Please make cheques out to 'The AsEditCo'.
@pa
Companies
---------
For individual use, the cost is as above with the restriction that
each user may only use EasyEdit II on his or her 'own' (ie the one
purchased for use by that individual) machine, or a designated
backup.
You may also wish to register your 'site' and distribute copies
yourself. In this case, the costs are as follows:
Up to Europe U.S.A. Manual
'right to copy'
10 licenses: £200 $300 £80 $120
20 licenses: £380 $550 £150 $225
50 licenses: £750 $1125 £250 $375
100 licenses: £1300 $1950 £400 $600
200 licenses: £2200 $3300 £600 $900
Unlimited £3500 $5250 n/a
You can order a mixture of the above. For instance, if your site
has between 50 and 70 PC's, you would order one '50' license and
one '20' license for a total saving of £1320 or $2080. A site
license entitles the company to a years worth of upgrades and a
copy of the professional manual. An unlimited site license
includes a 'right to copy' license for the professional manual.
Extra copies of the professional manual can be ordered at a cost
of £10.00 each (UK) or $20.00 each (USA). The extra USA cost is
for postage.
A site is defined as being a building, or set of buildings which
can all be reached by walking (typically within a radius of half a
mile). However, I am always open to negotiations.
For details on company-wide licenses, please contact me.
I can provide a limited amount of telephone support via the phone
number at the front of the manual. However, please remember that I
do have a 'real' job and would appreciate phone calls in the
evenings UK time, or at weekends. I will NOT return calls unless
it is really urgent or interesting (I define that criteria), since
this is not a commercial venture and I pay my own phone bills.
Please note that I cannot be help responsible for anything which
may result from you using EasyEdit II.
@pa
@tc0Installation
Installation and customisation
------------------------------
You will get this package in one of three ways:
either as a diskette, in which case, follow step A
or as a .EXE file, in which case, follow step B
or as a pre-installed program, in which case, do nothing.
STEP A
------
Follow the instructions in the file README.1ST which is on
the installation diskette.
STEP B
------
If you received the kit as a .EXE file, all necessary files will
be in the archive. This is a self-unpacking program. Copy the file
EASYEDIT.EXE to a subdirectory and type EASYEDIT [RET]. The
programs will unpack themselves automatically.
Then, if you wish the support file path to be stored inside the
EasyEdit program file, type in the following:
EE /E- /L:INIT.MAC /M:1 [RET]
Otherwise, set an environment variable, EEPATH, to point to the
support file directory from DOS as follows:
C:> SET EEPATH=C:\EE [RET]
Note that the environment variable EEPATH takes precedence
over the support file path.
You can also set five other environment variables:
1. EELPATH - which will point to a local directory for getting
the last file edited. This will normally be used by
network users. It also stored the keyboard file and
any local .CFG files.
2. EEAPATH - which can be used to point autosaves to a different
disk/directory when EasyEdit does its automatic
backups.
3. EESPATH - The directory where any swap files will be created
if you use the TSR option. It is a good idea to try
and use EMS memory or a large RAM disk if
possible. (This only applies to the registered
version.)
4. EERPATH - This is set to point to the directory where any R_C
files will be stored. If not set, they will be
stored in the same directory as the file being
edited.
5. EEBPATH - This can be set to point to a directory where your
backup files (.BAK) will be stored. If not set, they
will be stored in the same directory as the file
being edited.
After that, set the PATH command to point to the EasyEdit home
directory and you may start editing any file anywhere.
@pa
@tc0Keyboard customisation
Keyboard Customisation
----------------------
One of the really nice things about EasyEdit is that you can
customise the keyboard so that all the function keys will act how
you expect them to. This goes a long way to making EasyEdit one of
the nicest editors around and is a feature well worth having.
There is a program KBD_INST supplied which does it all for you. To
run it, type in
KBD_INST [RET]
The program will load and ask you two questions:
If you have an Enhanced keyboard, answer 'Y' to the first
question. The program will then use INT16 functions 10 and 11
rather than the Turbo Pascal READKEY function and therefore can
interpret the enhanced keyboard mappings properly. To use these
enhanced features, the parameter ENHANCED must be set ON in
EE.CFG. A complete list of extra keys available to you is
displayed in the 'Notes on enhanced keyboards' section.
If you wish to restore the key mappings from the file EEKEYF.ILE,
answer 'Y'. The file EEKEYF.ILE contains a binary copy of the
mapping of function keys to EasyEdit commands and can be useful
when you get a new version of EasyEdit.
You will then be presented with a full screen display of all the
available commands and the keys which are currently used to access
them. You will notice that there are two key sequences for each
command. You may enter a primary and secondary keystroke for each
command. However, all keystrokes must be unique. Note that the
MOUSE commands all use the primary keystrokes so please be careful
about modifying those.
To modify a command, move the cursor to the command in question
using the arrow keys and press [RET]. You can then press the key
sequence you want plus [RET] and that will be stored against that
command. Note that some commands are interpreted as 'control'
commands (eg 'C' to clear the display). If you wish then to be
included in the command, press the 'SCROLLOCK' key first and then
the command. Press the 'SCROLLOCK' key again to resume normal
operations.
The list of control commands are:
C Clear the current keystrokes
R Restore to the default on entry.
[RET] Accept the command
Ctrl-H Delete the previous character
<ESC> Finish editing keystrokes
When you are finished, press the <ESC> key. This will bring up a
message on the top line, asking if you wish for a keyboard map
file to be produced. Press 'P' to produce the file EEKEY.MAP and
another copy of the EEKEYF.ILE file, or press 'C' to continue. The
file EEKEY.MAP is a text file with all the commands plus the
primary and secondary keys needed to invoke them. This file may
then be edited in any way and saved for your further reference.
Another message will be presented asking if you wish to save the
key mapping in EE.EXE plus updating the help file EE.HLP to
reflect the new change. Press 'W' to save the data or 'Q' to quit
without saving. If you have modified any keys and choose the 'Q'
option, you will be asked to confirm that you wish to quit.
If you chose 'W', the keystrokes are saved in EE.EXE, the file
EEKEYF.ILE is updated and the help text (EE.HLP) is updated to
reflect the new changes. Be patient, there are over 2800 lines to
write here. It takes about 15 seconds on my machine.
Please note that the file EE.HLP is created by the keyboard
installation program (a default one is supplied) from the keyboard
mappings and the file EE.TXT. Please do not change that file or
the results will be unpredictable. The EasyEdit technical
reference manual will have details on the help file formats.
Note that the editing windows will use the centre arrow keys on an
enhanced keyboard if ENHANCED is set ON in EE.CFG (See below).
This is independant of the functions you assign to these keys.
Registered users
----------------
If you enter a filename on the command line (eg KBDINST MINE),
KBD_INST will save the keyboard mapping and help file to that file
rather than inside EE.EXE. Then, with the configuration option
KEYFILE, different users can have different keymappings without
having to run KBD_INST each time. EasyEdit searches first in the
EELPATH directory then EEPATH directory for these files.
Hint
----
Play with the program before diving into the KBD_INST routines.
Get to know what all the commands mean. Look at the defaults that
have been set up; a long time was spent thinking about the best
way to use the function keys and it works well.
@pa
@tc1Notes for Gold Key users
Notes for Gold Key users
There is a group of users who are accustomed to the Digital
style of word processing. This is known as 'GOLD KEY EDITING'
and relies on the user pressing a designated key (usually
marked in Gold), releasing that key and then pressing another
key to perform a certain action (such as saving a file etc).
This is an alternate form of control keys unique to Digital.
Now, EasyEdit can emulate this style using the <ESC> key as
the Gold key. This is in addition to, not instead of, all the
normal function, control and Alt keys which are so familiar to
PC users.
To set it up, use the KBD_INST program and get to the
keystroke to be modified. To enter an <ESC> character, press
<SCROLL LOCK> once, press <ESC> and then press <SCROLL LOCK>
again. Then press the secondary key associated with the action
and [RET] to have that keystroke accepted. Repeat this for all
the keys you wish modified.
I have provided two keyboard map files which emulate (as far
as possible) the WPS-PLUS keyboard on an enhanced keyboard and
on an LK250 keyboard.
Be assured, the <ESC> key will continue to function in its
normal manner whenever required. Nothing has been removed to
give you this extra facility.
You may also use the NUM-LOCK key to simulate the <ESC> key by
setting USENUMLOCK to ON in the file EE.CFG. To then change
the numeric pad, press ALT-NUMLOCK.
@pa
@tc0The EasyEdit Configuration Program
The EasyEdit Configuration Program
To speed up loading and starting EasyEdit, the program can
read most of its configuration from an environment variable
rather than from the file EE.CFG.
To invoke this, run the program EECFG. You will be shown a
full screen display of the options to be changed. Press the
letter associated with the option and it will toggle from TRUE
to FALSE or vice versa. The exceptions are SEARCHINIT where
you will have to specify a series of letters as outlined in
the Find Text menu option below and HOTKEY where you select a
number from 1 to 4 depending on the hotkey you wish to be
assigned which will invoke the TSR version of EasyEdit.
If, at any time, you press '?', a page of help text will be
displayed to assist you.
When finished, press <ESC> to exit the program. A file called
EECFGADD.BAT will be built in the current directory. You can
the include this in your AUTOEXEC.BAT file for future work and
also run it immediately to set up the environment.
I would suggest that (for DOS 3.3 users) you use the CALL
command so that any changes will not mean re-editing
AUTOEXEC.BAT.
eg in AUTOEXEC.BAT have the line
CALL C:\EE\EECFGADD
For DOS 3.2 and earlier, you will have to edit AUTOEXEC.BAT
each time. [Sorry, but thats life].
@pa
@tc0Files used
File Used and EasyEdit defaults.
--------------------------------
@tc1EELASTF.ILE
EELASTF.ILE - Stored in the home directory as defined with the
<F10>OLH command.
This contains the last file which was edited (in any directory).
This file is created by EasyEdit.
@tc1EE.CFG
EE.CFG - Stored in the home or current directory as defined with
the <F10>OLH command.
This contains lines to set/bypass some defaults. Each line contains
a keyword followed by an action, normally ON or OFF. Each keyword
and action is described below. You may use any editor (EasyEdit ?)
to create or amend this file.
Note that the keywords can be in either upper or lower case but they
MUST start in column 1 and must contain a space between the keyword
and the action.
Any line starting with a ';' is treated as a comment and will be
ignored (see the file EE.CFG for an example).
@tc2Environment variables
Environment variables
Any parameter starting with a '%' will be treated as an environment
variable and the environment table will be searched to obtain the
true value. This can have great benefits in networks.
eg, if the file EE.CFG contains the line 'SEARCHINIT %SEAR',
and the environment has been set up with SEAR=UG, then the
SEARCHINIT parameter will be 'UG'.
You can also enclose environment variables within a pair of '%' and
the information outside them will be unchanged. There can be
multiple pairs of variables on one line.
eg if the file EE.CFG contains the line LOADMACRO %mac%.%ext%
and the environment has been set with MAC=INIT and EXT=MMM,
then the expansion will be to LOADMACRO INIT.MMM.
You may also enclose the complete line within '%'s and replace them
by environment variables.
eg if the EE.CFG file contains:
%var1%
%var2%
and the environment contains:
var1=EMS OFF
var2=EDLAST ON
then I think you can see the results. It opens up all sorts
of possibilities.
If the parameter is not found in the environment table (ie, it has
not been set), then that option is set to null (''). It is YOUR
responsibility to check this.
The (D) is the default if that line is not in the file.
@pa
@tc2Keywords
Keywords
READROW OFF - Bypasses the 'read last row/col/margins'.
READROW ON (D) - Enables the 'read last row/col/margins'.
WRITER_C OFF - Do NOT write the .R_C file. This will also turn OFF
reading of the .R_C file and setting the row/column
to its last known position
WRITER_C ON (D) Write out the .R_C file whatever the status of the
READROW option.
EDLAST OFF - Bypasses the 'edit last file' option
EDLAST ON (D) - Enables the 'edit last file' option.
ENDHOME ON - If this feature is ON, the second and all subsequent
presses of the <HOME> and<END> keys will move the
cursor to the previous or next line as long as no other
keys have been pressed in between.
ENDHOME OFF (D) - Disables the feature.
FORMATCHAR character - This option enables you to change the format
character (default '@') to any single
character you wish. Thus, for compatibility
with Wordstar (R), you may wish to make the
format character a '.' (a period character).
SEARCHINIT characters This option enables you to set default
options to the FIND command. Thus, if you
always want to find upper and lower case, set
the characters to 'U'. See the file EE.CFG
for an example.
AUTOSAVE OFF (D) - Do not autosave.
AUTOSAVE ON - Save the file to a .ESV extension every 'SAVETIME'
minutes.
This option will back up the file every few minutes
(specified by the SAVETIME option), to a file with the
name of the file being edited and an extension of
.ESV. It does not affect the original file or the
backup (.BAK) file. If you abort the edit, the
original file is preserved.
When reading in a file, the autosave directory is
checked for a file corresponding to the one being
edited. If found, a message is displayed and you have
the option of restoring it.
The autosave will back up all files being edited as
long as they have been modified. It does NOT back up
linked files (editing the same file in two windows)
more than once. It does not change the status of the
'modified' flag (specified by an '*' next to the
filename). If the file has been modified, it WILL be
saved when you exit from the program.
If you abort the edit for any reason, the .ESV file
will still remain. This allows you to have an
intermediary file with some edits in it for you to
access (it all helps). You may delete this file
manually or wait for Easyedit to delete it on the next
save.
@pa
SAVETIME number - Number of minutes between autosaves. Default is 10.
Can be any number between 1 and 59 (minutes). If a
value outside that range is entered, AUTOSAVE is
turned off.
LEFTUP ON
LEFTUP OFF (D)
This option changes the action of the left arrow key
when it reaches the left margin.
If ON, the cursor will go to the last character of the
previous line.
If OFF, the cursor will stay at the left margin.
RIGHTDOWN ON
RIGHTDOWN OFF (D)
This option changes the action of the right arrow key
when it reaches the last character on the line.
If ON, the cursor will go to the first character of the next
line.
If OFF, the cursor will continue on the same line.
LOADMACRO Macrofilename - Load in the macro file named rather than
EE.MAC from the default (home) directory.
You will need to put in the name and
extension but NOT the directory
specification. If the file does not
exist, you will get an error message and
the program will continue.
If you wish to test macros in the current
directory, use the '/L:' command line
parameter. Then, when you are satisfied,
move the macro file to the home directory
and change the LOADMACRO filename.
RUNMACRO Macronumber - Run the specified macro number (0-9) in the
file specified above (or EE.MAC). The
default is NOT to run a macro.
If this option is enabled but there is no
macro file loaded, or if you enter a number
for which there is no macro, then the
RUNMACRO option is ignored
MOUSE ON (D)
MOUSE OFF
This option controls whether to use the mouse or not.
If set ON, EasyEdit checks for the presence of a Microsoft
compatible mouse and reads in the EEMOUSE.CFG (see below)
to set up the mouse key press assignments.
If set OFF, the mouse will not be used, even if it is
present.
@pa
TOCSEPARATOR char (Default is '.')
This option changes the default character used to connect
a Table of Contents line with its page number. eg, if the
separator is a '.', then a line could look like:
1 Top level - should have chapter heading........... 1
The '....' is the separator.
TOCCHAPTER ON (D)
TOCCHAPTER OFF
This option controls whether the level 0 TOC line has the
word 'Chapter' before it.
TOCLENGTH n (Default 70)
This option controls the position (column number) of the
page number in a Table of Contents listing.
TOCNUMBERS ON (D)
TOCNUMBERS OFF
This option controls whether to print numbers when a
table of contents listing is produced. For example:
1 Top level - should have chapter heading.................. 1
1.1 This is one level down................................. 1
1.2 One level down......................................... 1
1.2.1 This is level 2...................................... 1
TOCINDENT ON (D)
TOCINDENT OFF
This option controls whether to indent each different
level or not. In the example above, TOCINDENT is OFF. In
this example, TOCINDENT is ON.
1 Top level - should have chapter heading.................. 1
1.1 This is one level down............................... 1
1.2 One level down..................................... 1
1.2.1 This is level 2................................ 1
FINDSTART ON
FINDSTART OFF (D)
This option controls where the cursor is positioned after
a search text command is completed. If ON, the cursor is
positioned at the beginning of the string; if OFF, it is
positioned at the end of the string.
@pa
ABRMEM filename (default EEMEM.ABR)
Set ABRMEM to the name of a local Abbreviation file which
remains in memory all the time.
ABRFILE filename (Default EEFILE.ABR)
Set ABRFILE to the name of the abbreviation file which is
searched if the abbreviation is not found in the ABRMEM
file
COLFILE filename (Default - take colour map from EE.EXE).
Set COLFILE to the name of a file where the colour map is
stored.
EMS ON
EMS OFF (D)
Enable or disable EasyEdit attempting to put the overlay
file into EMS memory for faster access to the overlay
file. I have found that when running under DESQVIEW (tm)
with the LOADHI area completely full, that attempting to
move the overlay file into EMS memory can cause the system
to hang.
Note that if this option is set ON, even if you have no
EMS memory, then the SPAWN to DOS command (<SHIFT-F6>),
will swap most of EasyEdit out leaving a small stub.
BCHALT ON
BCHALT OFF (D)
If you start Easyedit with the /BC option, then it checks
the file for a binary attachment. The BCHALT option
determines whether or not editing will continue if no
binary file is found.
If BCHALT is ON, then editing is stopped if no binary
attachment is found.
If BCHALT is OFF, then editing continues.
LOCKFILE ON
LOCKFILE OFF (D)
With the LOCKFILE option enabled, every time a file is
opened for editing, a check is made that the file is not
in use by some other user. The file is then locked for
your personal use until you finish editing.
With this option disabled, editing is as before.
See the section below for further details.
LOCKEXT extension (default &%&)
You can change the default extension used to 'lock' files
in a multi-user or tasking environment to make it
compatible with other programs which use this principle
(eg Wordstar). Just enter the extension (up to 3
characters).
@pa
COMMFILE ON
COMMFILE OFF (D)
This option controls how the display of printer and macro
files appears. With COMMFILE ON, the stored comment is
displayed next to each filename. With COMMFILE OFF, no
comment is displayed but the display appears and scrolls
much faster.
CODEPAGE ON
CODEPAGE OFF (D)
This option controls whether EasyEdit can display Codepage
character sets or just the inbuilt ROM character sets.
With CODEPAGE ON, the RAM character set will be used but
you will not be allowed to switch to the 43/50 line
display mode. With CODEPAGE OFF, you will use the built
in character sets for your video card and can switch to
43/40 line mode. This only applies to EGA and VGA cards.
BLNAME ON (D)
BLNAME OFF
This option controls how EasyEdit starts up if EDLAST is
OFF (see above). If BLNAME is ON, and there is no filename
specified on the command line, then a new file will be
created with an initial name of 'BLNAME'. If BLNAME is
OFF, and there is no filename specified on the command
line, then a file window will open with '*.* as a wild
card and you can choose a filename from the list offered.
SAVEALL ON (D)
SAVEALL OFF
This option controls how the windows are closed down when
exiting from EasyEdit.
If SAVEALL is ON, all modified windows are saved.
If SAVEALL is OFF, the current window is saved and then
you are asked if you wish to save each other modified
window.
ENHANCED ON
ENHANCED OFF (D)
This option controls whether EasyEdit will use the
extra functionality of an Enhanced keyboard. You must
have set up the mappings in KBD_INST previously for any
extra features to be used. Note that any editing windows
will use the centre arrow keys if this option is set.
STARTNUM ON (D)
STARTNUM OFF
This option controls whether the printing starts with
page numbering turned on (default) or off.
@pa
HOLDDIR ON
HOLDDIR OFF (D)
This option determines whether or not EasyEdit will
revert to the current directory when returning from a
spawned command which may have changed the directory
specification. It has no effect on saving files which
have previously been edited.
IGNOREM ON
IGNOREM OFF (D)
This option controls how EasyEdit displays colours if the
system is switched to video mode 2 on a colour analog
monitor for any reason. Some software leaves the system in
the 'wrong' state (by assuming that modes 2 and 3 are the
same - they are not). EasyEdit will attempt to correct
this if you wish.
Set this option ON if you see EasyEdit coming up in
monochrome on a colour system.
Please do NOT set this option if you have a monochrome
graphics system (such as a portable). The grey shades
may be hard to read.
OWNMENU ON
OWNMENU OFF (D)
This option controls whether or not EasyEdit will attempt
to read in a customised menu file.
If set ON, the local support path (EELPATH) then the
global support path (EEPATH) will be searched for the
file EEMENU.CFG. If found, the file will be interpreted
and the new menu system used.
If set OFF, the built-in menu system will be used.
MAKEBACKUP ON (D)
MAKEBACKUP OFF
This option controls whether or not to create a .BAK file
when saving your work. If you are short of disk space, it
may be advisable to turn this option off.
If set ON, each time you save your work, a backup file
with the extension .BAK is saved with the contents of the
file before the last save.
If set OFF, the file is overwritten without any backup
being made.
@pa
HOTKEY n (default 1)
A number between 1 and 4 representing one of the
'hot-keys' used to invoke the TSR version of EasyEdit.
1 ALT-<TAB>
2 CTRL-<TAB>
3 ALT-`
4 CTRL-`
SWAPSIZE n (default 2048)
This is the number of paragraphs (a paragraph is 16 bytes)
to allocate as data space for editing when EasyEdit is set
up as a non-swapping TSR. The number can be any value
between 2048 and the maximum memory available. Invoke
EasyEdit as a TSR (/NS option) and you will be informed of
the range of options.
MOVEIN ON
MOVEIN OFF (D)
Use this option if you wish the press of the <HOME> key to
take the cursor to the first character of the line rather
than the first column. The next press of <HOME> will then
take the cursor to the first column (if no other key has
been pressed first).
DEFHEAD text
Use this option to define a default header to be used when
printing text. It will be overridden by any '@HE' commands
DEFFOOT text
Use this option to define a default footer to be used when
printing text. It will be overridden by any '@FT' commands
MYDICT ON (D)
MYDICT OFF
If this is set ON, then when the spell checker is invoked,
the internal dictionary will be used. If set OFF, then the
calls to Turbo Lightning will be used.
MDICT dictionary
This specifies the location and name of the master
dictionary. If this is left out, EasyEdit defaults to
EE.DCT in the EEPATH directory.
UDICT dictionary
This specifies the location and name of the user
dictionary. If this is left out, EasyEdit defaults to
USER.DCT in the EELPATH directory. [Note, this is the
LOCAL path]
@pa
COMPILER compilername
This option allows you to preset the name of the compiler
you use. It can have the path in as well. If not, the
compiler must be somewhere on your path. Currently,
EasyEdit supports the following names:
TPC Turbo Pascal (V5.5 and 6.0)
TCC Turbo C (V2.00)
TASM Turbo Assembler (V2.0)
CL Microsoft C (V5.10)
QCL Microsoft Quick C (V1.01)
MASM Microsoft Assembler (V5.10)
CSWITCH switches
This option allows you to set any default compiler
switches for the above compilers.
USENUMLOCK OFF (D)
USENUMLOCK ON
This option controls whether NUM-LOCK will simulate an
<ESC> key or not. This is primarily for GOLD KEY users.
KEYCOUNT num (D 1000)
This option sets the number of keys pressed before
AUTOSAVE takes place. Note that this value is only checked
once every minute.
KEYFILE name
If the file 'name'.KEY is found in the EELPATH or EEPATH
directory, then that key mapping and the associated EE.HLP
file is used. Do not put any extension on the 'name'.
REFORMLEFT ON
REFORMLEFT OFF (D)
IF this option is set on, any reformatting (using CTRL-B)
will move the first line back to the left margin rather
than reformatting from the current line.
DOUBLELINE ON
DOUBLELINE OFF (D)
If this option is set, any line drawing will be done using
the double line character set rather than the single line
one. This can be changed from within EasyEdit as well.
@pa
@tc1EEMOUSE.CFG
EEMOUSE.CFG
If a mouse is to be used and there is a microsoft compatible one
present in the computer, the file EEMOUSE.CFG is read in to set up
the assignment of mouse keys to EasyEdit commands. Each command
has a number (see the table below) and each type of mouse press
can be assigned a different number.
The rules governing the layout of the EEMOUSE.CFG file are the
same as the EE.CFG rules above.
Each mouse button can be pressed alone, with the Alt, Control or
Shift keys or any combination of the above. Most of the presses
can be assigned to EasyEdit commands. The exceptions are detailed
at the end of the following table, which explains the default
actions.
@TC2Mouse button table
Key Pressed Left Mouse Right Mouse Both Mouse
Button Button Buttons (1)
-----------------------------------------------------------------------
None See below See below Help summary
Alt Move Block Copy Block Nothing
Ctrl Nothing Hide Block Nothing
Left_Shift Help summary Abort action Nothing
Right_Shift Help summary Abort action Nothing
Alt-Left_Shift Delete line Undelete line Nothing
Ctrl-Left_Shift Nothing Nothing Nothing
Alt-Ctrl Nothing Nothing Nothing
Alt-Ctrl-L_Shift Delete block Insert undo buffer Nothing
-----------------------------------------------------------------------
(1) For a three button mouse, the centre button defaults are the same
as the 'both button' defaults.
With the Left Mouse button alone, a press defines the beginning of a
marked block and a release defines the end of a marked block. The
block will be highlighted as you move the mouse.
With the Right Mouse button alone, pressing it while editing will
bring up the menu system. Pressing it while in the menu system will
take you back up menu levels until the menu system is exited.
Once into the menu system, mouse movement down, or the left mouse
button will select a lower menu level. At the lowest level, the left
mouse button selects that option.
When the help screen is displayed, pressing the left button will
select the menu item and pressing the right button will cancel that
selection. Moving the mouse up or down will invoke the previous or
next page if appropriate.
The mouse movement is translated into cursor movement.
@pa
@tc1Mouse key defaults
All the options can be modified by editing the file EEMOUSE.CFG. The
commands are detailed below with the default option shown. There is
also a separate file COMMANDS.LST in the distribution kit which
details the valid commands.
LEFTALT 57 Left Mouse button plus ALT key
RIGHTALT 56 Right Mouse button plus ALT key
LEFTCTRL 113 Left Mouse button plus Control key
RIGHTCTRL 59 Right mouse button plus Control key
LSHIFTLEFT 174 Left mouse button plus Left Shift key
LSHIFTRIGHT 192 Right mouse button plus Left Shift key
RSHIFTLEFT 174 Left mouse button plus Right Shift key
RSHIFTRIGHT 192 Right mouse button plus Right Shift key
LSHIFTALTLEFT 32 Left mouse button plus Left Shift and Alt keys
LSHIFTALTRIGHT 22 Right mouse button plus Left Shift and Alt keys
LSHIFTCTRLLEFT 193 Left mouse button plus Left Shift and Ctrl keys
LSHIFTCTRLRIGHT 193 Right mouse button plus Left Shift and Ctrl keys
ALTCTRLLEFT 193 Left mouse button plus Alt and Ctrl keys
ALTCTRLRIGHT 193 Right mouse button plus Alt and Ctrl keys
ALLLEFT 58 Left mouse button plus Alt,Ctrl and Left shift keys
ALLRIGHT 116 Right mouse button plus Alt,Ctrl and Left shift keys
ALONEBOTH 174 Both mouse buttons alone
RSHIFTBOTH 193 Both mouse buttons plus Right shift key
LSHIFTBOTH 193 Both mouse buttons plus Left shift key
BOTHCTRL 193 Both mouse buttons plus the Control key
LSHIFTCTRLBOTH 193 Both mouse buttons plus Left Shift and Ctrl keys
BOTHALT 193 Both mouse buttons plus the Alt key
LSHIFTALTBOTH 193 Both mouse buttons plus Left shift and Alt keys
ALTCTRLBOTH 193 Both mouse buttons plus Alt and Ctrl keys
ALLBOTH 193 Both mouse buttons plus Alt,Ctrl and Left Shift keys
ALONECENT 174 Centre mouse buttons alone
RSHIFTCENT 193 Centre mouse buttons plus Right shift key
LSHIFTCENT 193 Centre mouse buttons plus Left shift key
CENTCTRL 193 Centre mouse buttons plus the Control key
LSHIFTCTRLCENT 193 Centre mouse buttons plus Left Shift and Ctrl keys
CENTALT 193 Centre mouse buttons plus the Alt key
LSHIFTALTCENT 193 Centre mouse buttons plus Left shift and Alt keys
ALTCTRLCENT 193 Centre mouse buttons plus Alt and Ctrl keys
ALLCENT 193 Centre mouse buttons plus Alt,Ctrl and Left Shift keys
@pa
@tc1Mouse configuration options
In addition to all the above, the movement of the mouse can be
controlled by options in the configuration file.
HMICKEY number (default 8)
VMICKEY number (default 8)
These are divisors to the basic cursor movement to slow down
the speed of moving the mouse. HMICKEY is for horizontal
movement and VMICKEY is for vertical movement.
SLOWMENU number (default 3)
This option slows down the cursor movement even more when in
the menu system. This is because EasyEdit is doing no
background processing and thus looking for keystrokes more
frequently.
BOTHDELAY number of milliseconds (default 100)
This option is the allowable delay when pressing both buttons
before EasyEdit will assume that only one button has been
pressed. For those with 3 button mice for which the middle
button emulates pressing both, this can be set to zero.
@pa
@tc1Easyedit Commands list
EasyEdit Commands list
EasyEdit commands are as follows:
Command Description
number of command
0. Left one character
1. Right one character
2. Left one word
3. Right one word
4. Up one line
5. Down one line
6. Scroll up
7. Scroll down
8. Down one page (window length)
9. Up one page (window length)
10. Top of window
11. Bottom of window
12. Cursor to left side (home)
13. Cursor to right side (end)
14. Top of screen
15. Bottom of screen
16. Move to previous BEGIN line
17. Move to previous END line
18. Goto line n
19. Goto column n
20. Goto window n
21. Previous cursor position
22. Undo last deletion
23. Restore line as on entry
24. Tab, either fixed or "smart"
25. Insert control character into text
26. New line in text buffer
27. Insert line
28. Delete current character
29. Delete left character
30. Delete right word
31. Delete line right of cursor
32. Delete line
33. Delete line, no undo
34. Find pattern
35. Find and replace
36. Search and apply macro at position
37. Find next
38. Invoke a DOS shell
39. Backward tab
40. Edit a new file in current window
41. Abandon file
42. Read file into window
43. Save file
44. Write block to file, not appending
45. Save file and exit
46. Add second window with same or different file
47. Resize current window
48. Save current file, and get a new one
49. Switch windows
50. Put up a help summary
51. Make the current window fill the screen (zoom)
52. Begin block
53. End block
54. Top of block
55. Bottom of block
56. Copy block
57. Move block
58. Delete block
59. Hide block marking
60. Mark current word as block
61. Toggle text marker display
62. Set marker 0
63. Set marker 1
64. Set marker 2
65. Set marker 3
66. Set marker 4
67. Set marker 5
68. Set marker 6
69. Set marker 7
70. Set marker 8
71. Set marker 9
72. Jump to marker 0
73. Jump to marker 1
74. Jump to marker 2
75. Jump to marker 3
76. Jump to marker 4
77. Jump to marker 5
78. Jump to marker 6
79. Jump to marker 7
80. Jump to marker 8
81. Jump to marker 9
82. Load a set of macros from disk
83. Write current macros to disk
84. Toggle macro recording
85. Insert Macro 1 once
86. Insert Macro 2 once
87. Insert Macro 3 once
88. Insert Macro 4 once
89. Insert Macro 5 once
90. Insert Macro 6 once
91. Insert Macro 7 once
92. Insert Macro 8 once
93. Insert Macro 9 once
94. Insert scrap macro n times (prompted)
95. Insert scrap macro once
96. Insert scrap macro twice
97. Insert scrap macro 3 times
98. Insert scrap macro 4 times
99. Insert scrap macro 5 times
100. Insert scrap macro 6 times
101. Insert scrap macro 7 times
102. Insert scrap macro 8 times
103. Insert scrap macro 9 times
104. Show system information
105. Show available memory
106. Toggle insert mode
107. Toggle autoindent mode
108. Toggle case of character(s)
109. Lower case character(s)
110. Upper case character or block
111. Set the right margin for word wrap and reformat
112. Reformat the current paragraph
113. Toggle word wrap on or off
114. Set the left margin for word wrap
115. Toggle tab line display on or off
116. Insert undo buffer at cursor
117. Toggle right justification
118. Toggle Pagination display
119. Toggle on-screen attribute display
120. Centre] the current line in margins
121. Set editor colours
122. Save colours, toggles, etc for new time (save defaults)
123. Print a file
124. Flush undo buffer
125. Draw a box
126. Toggle line drawing
127. Log drive or path
128. Show directory
129. Go to specified page
130. Set default top margin
131. Set default bottom margin
132. Set default page length
133. Set default undo limit
134. Toggle tab expansion on read-in
135. Get a new default file extension
136. Set the tabs
137. Set default tab size
138. Write current tab line into text
139. Interactively edit the tabs
140. Set temporary margin for word wrap
141. Reformat marked block
142. Close window, on last one, enter menus
143. Prompt for a marker number to set
144. Prompt for a marker to jump to
145. Prompt for a macro to insert
146. Toggle between fixed and "smart" tabs
147. Set temporary margin at current column
148. Set the path to all the support files
149. Toggle high bit stripping on read-in
150. Edit a macro
151. Save current window to another file
152. Toggle display of keyboard help in menu system
153. Move to previous window
154. Next sentence
155. Previous sentence
156. Restore to default (even) tabs
157. What font is cursor on
158. Insert Bold toggle
159. Insert Doublestrike toggle
160. Insert Underscore toggle
161. Insert Superscript toggle
162. Insert Subscript toggle
163. Insert Compressed font toggle
164. Insert Italic font toggle
165. Toggle snow checking
166. Toggle block cursor mode
167. Toggle EGA 43 line mode
168. Set margin release
169. Spell checker
170. Delete all attributes in current marked block
171. Toggle tabs written to compress output
172. Toggle compression prior to wrap
173. Toggle default zoom state
174. Help summary menu
175. Help regarding help system
176. Help on cursor movement
177. Help on quick movement
178. Help on insert and delete
179. Help on Search and replace
180. Help on files
181. Help on window commands
182. Help on Block commands
183. Help on text commands
184. Help on tab commands
185. Help on utilities
186. Help on settings
187. Help on line and box drawing
188. Help on macros
189. Help on printing
190. Function key listing
191. Activate the menu system
192. Abort current operation
193. No operation indicated
194. No op - used by menu system
195. Set high bit stripping on read in
196. Unset high bit stripping on read in
197. Expand previous abbreviation.
198. Append a binary file to the current window and exit.
Only exits if current window has been modified.
199. Display a count of the number of words in the current
window.
200. Extract a binary file from the file in the current
window
201 Perform a set of commands multiple times
202 Find matching pairs
203 Reserved
204 Add macro file comment
205 Toggle between Line and Column mode for block work.
206 Make a window Read-Only
207 Make a window Read-Write (if allowed)
208 Search for the next occurance of the word under the
cursor
209 Toggle the single key select function
210 Move to the first line of the next paragraph
211 Move to the last line of the previous paragraph
212 Toggle out of the TSR back to the calling app.
213 Move all windows up one line
214 Move all windows down one line
215 Invoke the compiler options
216 Delete word to the left of the cursor
217 Toggle single/double line drawing mode
218 Copy or delete a file
@pa
@tc0Overriding options with switches
Overriding options from the command line (switches).
----------------------------------------------------
Most of the options specified above can be overriden by switches
from the command line. A switch is a '/' character followed by a
letter and, optionally, an extra parameter. The switch can be in
either upper or lower case.
The following are valid switches:
/R+ /R- Turn on or off reading .R_C file
/E+ /E- Turn on or off reading in last edited file
/L:macrofile Load a named macrofile.
/M:x Run macro number 'x'.
/A+ /A- Turn autosaves on or off.
/I+ /I- Start off in insert or overstrike modes
/T+ /T- Write tabs on output or spaces
/W+ /W- Start off with wordwrap on or off
/J+ /J- Start off with right justify on or off
/P+ /P- Start off in 'page mode' or not.
/T:n Set tab size to 'n'
/BC Check the file for the inclusion of a binary
file.
/AB When exiting, automatically ask for a binary
file to add if window (file) has been modified
/G:nnn Go to line 'nnn' on entry to the file.
/RO Make the preceding file read-only
/NB Don't make a .BAK file when saving a window.
/TS Set EasyEdit up as a TSR with all the defaults
/NS Set EasyEdit up as a non-swapping TSR
/FI Force EasyEdit to use files for swapping even
if EMS memory is present.
/UN Unload EasyEdit from memory.
/K:n Use 'hot-key' no 'n' (1-4) when invoking
EasyEdit.
@pa
@tc1Switch descriptions
Descriptions of each switch follow:
a) You can temporarily override the READROW option by adding onto the
command line either /R- or /R+ to disable/enable that option for
the current editing session.
eg EE AFILE.DAT /R+ will read in AFILE.DAT and, if the
.R_C file is found, will set the row, column and margins.
EE AFILE.DAT /R- will read in AFILE.DAT and ignore any
.R_C file.
b) You can ask EasyEdit to temporarily override the EDLAST option by
adding onto the command line either /E- or /E+ to disable/enable
that option for the current editing session.
You can stop it reading in the last file edited by adding a /E-
when starting up the editor. In this case, you will be editing a
new file and will be asked for a filename when it is saved.
eg EE /E-
You can force EasyEdit to read in the last edited file with the
/E+ option.
eg EE /E+
Note that the file EELASTF.ILE is created whichever option is in
effect.
c) You can specify a macro file to be read in to override the default
by using the '/L:filename' switch. The filename must be the FULL
file specification including the disk, directory and file
extensions.
eg EE EASYEDIT.TXT /L:B:\INIT2.MAC
d) You can specify a macro number to run with the /M:x option (x=1-9).
eg EE /M:2 will run macro number 2 from the loaded macro
file.
e) You can stop the autosave temporarily by adding a /A- on the
command line. You may want to do this, for instance, if you are
editing a file on a floppy drive and don't want the extra file.
eg EE EASYEDIT.TXT /A-
You can start the Autosave option by adding a '/A+' to the command
line.
eg EE EASYEDIT.TXT /A+
@pa
f) You can start off in Insert mode, whatever the default is set to
by adding the /I+ option to the command line.
eg EE filename /I+
You can start off in Overstrike mode, whatever the default is set
to, by adding the /I- option to the command line.
eg EE filename /I-
g) You can set tabs to be written on output, rather than multiple
spaces, by adding the /T+ option to the command line.
eg EE filename /T+
You can set spaces to be written on output, rather than tabs, by
adding the /T- option to the command line.
h) You can start off with word wrap enabled, whatever the default is
set to, by adding the /W+ option to the command line.
eg EE filename /W+
You can start off with word wrap disabled, whatever the default is
set to, by adding the /W- option to the command line.
eg EE filename /W-
i) You can start off with right justification enabled, whatever the
default is set to, by adding the /J+ option to the command line.
eg EE filename /J+
You can start off with right justification disabled, whatever the
default is set to, by adding the /J- option to the command line.
eg EE filename /J-
j) You can start off with page breaks displayed, whatever the default
is set to, by adding the /P+ option to the command line.
eg EE filename /P+
You can start off with page breaks hidden, whatever the default is
set to, by adding the /P- option to the command line.
eg EE filename /P-
k) You can set the tab size default to any value (between 1 and 9)
using the /T:n option where n is a number between 1 and 9. If you
wish to set tabs outside this range (eg 15), you must use the menu
to set it ( <F10>OTT ).
eg EE filename /T:5 sets the tab size to 5 characters.
@pa
l) When reading in a file, you can get EasyEdit to check for the
inclusion of a binary file (such as a spreadsheet) and extract it
automatically by adding '/BC' to the command line. You will be
asked to confirm the filename before it is written (see later).
m) To automatically get EasyEdit to append a binary file to the
text, add the '/AB' switch to the command line. This option can
also be invoked from the 'File' menu option. If the file has not
been modified, then EE exits as normal.
n) You can go directly to a line within a file by using the /G:
option. This option works unless you specify wildcards in the
filename, when it is ignored.
eg EE NEWFILE.PAS /G:127
will open file NEWFILE.PAS and position the cursor on line
127.
o) You can make a window read-only from the command line by
specifying the /RO option. This option only works if there is a
preceding filename on the command line.
eg: EE oldfile.txt /RO newfile.txt
will open 'oldfile.txt' in a read-only window and open
'newfile.txt' in a normal window.
p) You can avoid creating a .BAK file when saving files by setting
this switch.
Note, the following switches are all to do with the TSR
options inside the registered version of EasyEdit. TSR's are
explained in more detail in a later chapter.
q) Set EasyEdit up as a TSR with the /TS switch. It will be made
resident with all the defaults.
r) Set EasyEdit up as a non-swapping TSR with the /NS switch. The
swapsize is defined in EE.CFG (default is about 29Kb of editing
space).
s) Force EasyEdit to use EMS memory if there (and enough available)
for its swapping space with the /EM switch. This is only needed if
Digitals PCSA is active and you wish to override the default.
t) Force EasyEdit to use files for swapping even if EMS memory is
present with the /FI switch. You may wish to save the EMS memory
for other things.
u) Unload EasyEdit from memory with the /UN switch. An error message
will be displayed if EasyEdit is not resident or if there are
still unsaved files. If you get the message 'not enough memory',
use the EEUNLOAD program.
@pa
v) Select the 'hot-key' to be used with the /K:n option. choices are:
1 ALT-<TAB>
2 CTRL-<TAB>
3 ALT-`
4 CTRL-`
Notes
the options from (f) to (k) can be made permanent by invoking the
'Save Defaults' in the options menu.
You can combine the switches. eg
EE file /R- /M3
The options and switches can be either upper or lower case.
If a switch is entered more than once, then the LAST one will be
executed, the others will be ignored.
eg EE /E- /E+ /R- [RET] The first '/E-' will be ignored and
the other two switches executed.
If any of options (r) to (v) are used, the option (q) - /TS - is
not needed.
@pa
@tc0Invoking EasyEdit
Invoking EasyEdit.
------------------
The main file is EE.EXE. You call it as follows:
EE filename (filename2 3 4 5 6) switches [RET]
'filename' is the name of the file you want to edit.
'filename2 3 4 5 6' are optionally other files you can load in
at the same time. Although you may edit up to 6 files at once,
you can put more files on the command line. In this case, you
will get an error message and only the first 6 files will be
read in. Do NOT enter the brackets '()' on the command line.
They are there for display in this manual only.
'switches' are optional switches as described above. In
summary, you have:
/R+ /R- Turn on or off reading .R_C file
/E+ /E- Turn on or off reading in last edited file
/M:x Run macro number 'x'.
/A+ /A- Turn autosaves on or off.
/L:macrofile Load a named macrofile.
/I+ /I- Start off in insert or overstrike modes
/T+ /T- Write tabs on output or spaces
/W+ /W- Start off with wordwrap on or off
/J+ /J- Start off with right justify on or off
/P+ /P- Start off in 'page mode' or not.
/T:n Set tab size to 'n'
/BC Check the file for the inclusion of a binary
file.
/AB When exiting, automatically ask for a binary
file to add if the file has been modified.
/G:nnn Go to line 'nnn' in the file.
/RO Make the preceding file read-only
/NB Don't make a .BAK file when saving a window.
/TS Set EasyEdit up as a TSR with all the defaults
/NS Set EasyEdit up as a non-swapping TSR
/FI Force EasyEdit to use files for swapping even
if EMS memory is present.
/UN Unload EasyEdit from memory.
/K:n Use 'hot-key' no 'n' (1-4) when invoking
EasyEdit.
@pa
You may invoke EasyEdit using wildcards (* and ?) in place of
a filename. In this case, you will be presented with a listing
of all files which match your specification and you may choose
one using the arrow keys to select.
eg EE *.PAS
will open a window containing all files with a .PAS
extension. Choose one by moving the highlight using
the cursor keys or pressing enough letters to make it
unique and then press [RET].
Please note that, in this case, all switches on the command
line will still be obeyed EXCEPT the /M:n ./RO and /G:nnn
switches.
@pa
@tc1Initialisation sequence
Initialisation sequence
-----------------------
When you start up EasyEdit II, if the environment variable EECFG
is not set, it first looks for a file called EE.CFG in the the
home directory (where EasyEdit is stored or where the environment
variable EEPATH looks at). This file contains the default settings
as described above. If the environment variable EELPATH has been
set, the file EE.CFG is searched for again. This is for network
users so that users may override defaults for their own use.
If a mouse is present and is to be used, then the default options
stored in EEMOUSE.CFG are read in. The files used are read in as
above.
Any abbreviations are read in and set up.
Any matching pairs are read in.
If a colour map file exists, it is read in.
If the help file can be found, it is opened ready for use.
If a user replaceable menu system is asked for, the file EEMENU.CFG
is searched for and loaded. The directory EELPATH is searched
before EEPATH.
The program then attempts to load the default macro file EE.MAC or
one named by the LOADMACRO option above.
Then, the default printer definition table and character
translation table (if present) are read in.
If there is no filename present on the command line, the program
then looks for a file EELASTF.ILE in the home directory, if
requested by the EDLAST option, and then attempts to open the
filename found within that file.
The program then attempts to open a file called 'filename'.R_C in
the CURRENT directory or the one pointed to by the EERPATH
environment variable (if set). This contains the following:
Last column edited
Last row edited
Current Left margin
Current Right Margin
Current Top Margin
Current Bottom Margin
Current Page Length
Current Page number (if in page mode)
for the 'filename' being edited.
@pa
Note that, for the current window, if the page number is found, the
window will be set to display pages whatever the status of the
default. It also overrides the '/P+' option. If the page number is
not found, then the page display will be disabled, whatever the
default or command line (/P-) options.
This information is saved whenever the file is saved.
After that, the file requested is read in, if it exists, and you may
start editing.
@pa
@tc0Editing principles
Editing Principles
------------------
This section discusses the best way to utilize EasyEdit to its
full advantage. It is assumed that the user is familiar with the
PC keyboard and the layout of the function keys.
@tc1Entering information into windows
Entering information into Window boxes
--------------------------------------
At various times through the editing session, you may have to
enter information (such as filename to print) into special
windows. The following editing information applies here:
1. If you start typing, any previous information is erased.
2. If you use the arrow keys, you can edit previous information.
3. At any time, you can use the arrow keys to go back and forwards
editing the information entered. The <INS> key can toggle
between Insert and Overstrike modes although the status line
will not change.
@tc1The status line
The Status Line
---------------
At the top of each window is a status line with information about
that window.
0-2 An indicator >Z< to show if the window is zoomed.
3 An '*' to show if the file has been modified or an '°' if
the file is marked as read-only.
4-15 Filename
17-20 How far through the file (percent)
22-31 Current line number
33-39 Current column number
41-47 Current page number if page formatting is ON, or the
current buffer number if page formatting is OFF.
51-52 An indicator if you are using a mouse.
54-55 BL if in Line mode, BC if in Column mode or CS if single
key select mode is on
57-59 Insert/Overwrite indicator
61-62 Auto Indent indicator
64-67 Word wrap or margin release indicator
69-72 Justification ON/OFF indicator
74-75 Line Drawing indicator (<>)
76-80 Printing >P< or Macro recording >R< or the current
attribute under the cursor (or the time if nothing else).
@pa
@tc1Line and box drawing
Line and Box Drawing
--------------------
EasyEdit has the facility to draw lines and boxes using the IBM
extended character set. It uses the single line characters only.
@tc2Drawing Lines
Drawing Lines.
--------------
I call this the 'pen-down' method. Its as though you put the pen
down on the paper when you toggle the appropriate key.
This is done using the cursor keys in much the same way as you
would enter text. There are two main stages:
1. Toggle the line drawing option ON using the <Alt-F4> key.
An indicator will appear in the top left of the current
window status line.
2. Use the cursor keys to move the cursor which will 'pull'
lines after itself. Any connections with other lines will
result in the appropriate character being drawn.
Note that all lines are drawn in OVERSTRIKE mode; i.e. any
characters under the cursor are replaced by the lines.
However, remember that you may still be in INSERT mode when
entering normal text which could lead to misalignment of
lines.
When you are finished drawing lines, turn OFF the option using
the <Alt-F4> key again.
Please note that the line isn't drawn until the cursor moves.
Thus, the line appears to be one character behind the cursor.
This is the same as typing normal characters but looks strange
when moving up, down and backwards.
One of the useful things you can do with this is to have the
line drawing option enabled in one window and disabled in
another window (both onto the same file). In this way, you can
write the text in one window and then draw boxes around it.
@pa
@tc2Drawing boxes
Drawing Boxes.
--------------
This option allows you a quick way of drawing a rectangular
box on the screen. Once again, there are two stages to go
through:
1. Mark one corner of the box using the <Alt-F5> key. A marker
will be displayed at that point (':').
2. Move the cursor to the opposite corner of the area you want
'boxed' and press <Alt-F5> again. A box will be drawn and
the marker removed. This second mark can be above, below,
left or right of the first mark.
If you decide you do not want a box, move the cursor over the
marker and press <Alt-F5>. The marker will be cancelled.
You may not draw a box where the columns or rows are the same.
If you try this, the second <Alt-F5> will be ignored. If you
want single lines, use the Line Drawing as described above.
If you 'lose' the position of the first mark, you may use the
menu system marker option to move the cursor to it. It will be
the marker displayed on the goto marker menu ( <F10>GM ) which
is shown with a ':'
Note that all lines are drawn in OVERSTRIKE mode; i.e. any
characters under the cursor are replaced by the lines.
However, remember that you may still be in INSERT mode when
entering normal text which could lead to misalignment of
lines.
Note that you can use the macro facility to automate the drawing
of lines and boxes.
Double lines can be drawn by toggling that option.
@pa
@tc1Printing
Printing
--------
EasyEdit has the capability to print files whilst still editing.
In addition, it can print to many different printers or print to a
disk file for later printing.
While printing, it will initialise the printer using a user
defined print string, do character translation based on a
translation table and has several built in formatting commands
including headers and footers and table of contents.
Formatting commands all start with a '@' in column 1 followed by a
2 character code and optionally some extra information. The
format character can be overridden by a parameter in the EE.CFG
file.
@tc2Formatting characters
Formatting commands are as follows:
@PO n Offset the page to the right by 'n' columns
@PA Start a new page
@CP n Start new page if fewer than 'n' lines remain
@PN n Set page number to 'n'
@OP Turn page numbers OFF
@PG Turn page numbers ON
@PC n Print page numbers in Column 'n'
@PL n Set page length to 'n' lines
@MT n Set top margin to 'n' lines
@MB n Set bottom margin to 'n' lines
@HM n Set header margin to 'n' lines
@FM n Set footer margin to 'n' lines
@HEstring Use 'string' as a header on each page
@FOstring Use 'string' as a footer on each page
@TCltext Print the text to a Table of Contents file (see below)
@LS x Change to x line spacing (x between 1 and 9)
@FTFont Change to the named font type (See later)
Within the header and footer string, the following codes are valid
$ Insert the name of the file being printed
^ Insert the files creation/modified date.
# Insert current page number
%1 Insert current date as Aug 17, 1989
%2 Insert current date as 17 Aug 1989
& Insert current time
<Ctrl-K> Ignore trailing spaces on even pages
\ Take the next character literally
Headers and footers will NOT be printed if the top and bottom
margins are set to 0. This includes page numbers.
eg @HEThis line is printed on page # at %1
will print as a header at the top of each page as
This line is printed on page 12 at 01 Mar, 1987
@pa
@tc2Table of contents
Table of Contents.
When EasyEdit prints a file, it creates a new file with the name
the same as the file to be printed but with an extension of
'TOC'. This file will contain any information entered by the @TC
command above. The command structure is as follows:
'@TCltext' where: [Note: no spaces]
@TC is the command (always starting in column 1)
l is a level number from 0 to 9.
text is the text to be printed.
So, for example, if within your text file, you had several lines
as follows:
@tc0Top level - should have chapter heading
@tc1This is one level down
@tc1One level down
@tc2This is level 2
@tc0Back to a chapter
@tc1Last line
@tc3Level 3 line
The output might look like:
Chapter 1 Top level - should have chapter heading........... 1
1.1 This is one level down.......................... 1
1.2 One level down.................................. 1
1.2.1 This is level 2............................... 1
Chapter 2 Back to a chapter................................. 1
2.1 Last line....................................... 1
2.1.0.1 Level 3 line................................ 1
The exact look of the output depends on the options specified in
the EE.CFG file.
The .TOC file is only created if there are some @TC commands in
the print file (see hint 12 below).
If you are printing the .TOC file, then a temporary .TC2 file is
created.
@pa
@tc1Abbreviations expansion
Abbreviations expansion
-----------------------
@tc2Explanation
Explanation
EasyEdit has the ability to expand abbreviations based on a
user supplied list. An abbreviation can be from 1 to 3
characters followed be a space. The expansion will be any set
of up to 25 characters including spaces.
There are two files involved here: a Memory file and a File
file. The Memory file contains up to 50 abbreviations and
their expansions which are loaded into memory when EasyEdit is
invoked. The File file contains any number of abbreviations
and their expansions.
The filenames are controlled by the options in the EE.CFG
file but the defaults are EEMEM.ABR for the Memory file and
EEFILE.ABR for the File file.
When the expansion is invoked (Default ALT-T), EasyEdit
searches its memory list. If the abbreviation is found, the
expansion is put in its place. If not, the File file is
searched for the abbreviation.
Expansions can be added to the File file and they will be
immediately effective. Expansions can be added to the Memory
file but will not be effective until the next time EasyEdit is
invoked.
Note that the abbreviations are case sensitive; that is, 'CAD'
is not the same as 'cad'.
@tc2File Structure
File Structure
Both file types have the same structure:
Each abbreviation and expansion must be on the same line and
there can only be one per line
The abbreviation starts in column 1 and can be up to 3
characters. The expansion follows after 1 space and can be up
to 25 characters long including spaces.
eg
CED Synonyms for C.E.D.
CAD Computer Aided Display
DP Data Processing
@pa
@tc1Notes on Font Files
Notes on Font Files
EasyEdit (from version 2.5) has the ability to use several
fonts in the same document. Obviously, your printer must have
this facility or nothing will happen.......
The advantage of this is that you can define codes for
different printers with the same name and not have to change
your text when swapping printers.
To define all the fonts, use a text editor to create a font
file with the same name as the printer definition file and
with the extension of '.FNT'.
For each font, you need one line which starts with the font
name (upper or lower case) and then has a space and then has
the codes necessary to invoke that font with your printer. The
total line length cannot exceed 80 characters.
eg, if the code to produce Times Roman 12 point was '<ESC>#3'
then the line might look like:
TIMES12 <ESC>#3
Then in the text, you specify '@FTTIMES12' as a print code and
the sequence '<ESC>#3' will be sent to your printer to turn on
Times Roman 12 point.
An example for an HP Deskjet printer is included. A subset of
it is printed below with the ESCAPE character replaced by
<ESC>.
Courier10/6 <ESC>(s0P<ESC>(s3T<ESC>(s10H<ESC>(s6V
Courier16/6 <ESC>(s0P<ESC>(s3T<ESC>(s16.67H<ESC>(s6V
Courier20/6 <ESC>(s0P<ESC>(s3T<ESC>(s20H<ESC>(s6V
Courier5/12 <ESC>(s0P<ESC>(s3T<ESC>(s5H<ESC>(s12V
Courier10/12 <ESC>(s0P<ESC>(s3T<ESC>(s10H<ESC>(s12V
Courier16/12 <ESC>(s0P<ESC>(s3T<ESC>(s16.67H<ESC>(s12V
Courier20/12 <ESC>(s0P<ESC>(s3T<ESC>(s20H<ESC>(s12V
Times12 <ESC>(s1P<ESC>(s12V<ESC>(s5T
Times10 <ESC>(s1P<ESC>(s10V<ESC>(s5T
Times8 <ESC>(s1P<ESC>(s8V<ESC>(s5T
Times7 <ESC>(s1P<ESC>(s7V<ESC>(s5T
Times6 <ESC>(s1P<ESC>(s6V<ESC>(s5T
Times5 <ESC>(s1P<ESC>(s5V<ESC>(s5T
Times4 <ESC>(s1P<ESC>(s4V<ESC>(s5T
Prestige6/10 <ESC>(s0P<ESC>(s8T<ESC>(s6H<ESC>(s10V
Prestige12/10 <ESC>(s0P<ESC>(s8T<ESC>(s12H<ESC>(s10V
Prestige24/10 <ESC>(s0P<ESC>(s8T<ESC>(s24H<ESC>(s10V
Prestige8/7 <ESC>(s0P<ESC>(s8T<ESC>(s8H<ESC>(s7V
Prestige16/7 <ESC>(s0P<ESC>(s8T<ESC>(s16.67H<ESC>(s7V
Prestige33/7 <ESC>(s0P<ESC>(s8T<ESC>(s33.34H<ESC>(s7V
Letter <ESC>(s2Q
Draft <ESC>(s1Q
@pa
@tc0Notes on Binary files
Notes on Binary files
---------------------
EasyEdit (from version 2.2) has the ability to include binary
files in its text as 'encoded text'. This gives the user the
ability to send the file to another user via a text-only mail
system and have the file unencoded at the other end back to
its original form.
The file format is UUENCODE and UUDECODE which are public
domain algorithms. The format has been extended to be
compatible with other mail programs.
The text file contains the following header which EasyEdit
searches for when extracting the file:
<Ctrl-B><Ctrl-B><Ctrl-B>+++Binary Attachment: Filename
Begin 777 Filename
If you wish to change the filename before it extracted, change
the FIRST one. Please be warned that if you attempt to alter
the first part of the line (as shown above), the extraction
may not work.
@tc1Encoding a file
Encoding a file
To include a file for encoding (such as a Lotus spreadsheet),
enter your introductory text as normal. (This could be some
explanation of what the file is etc). Then, when exiting, use
the <F10>FA option rather than <F10>FE option.
You will be asked for the file to encode. Enter any legal
filename. If the file does not exist, you are given the
opportunity to re-enter it or exit without encoding. If the
file does exits, a message is displayed at the top of the
screen (so you know something is happening) and the binary
file will then be appended to any text you may have entered.
Alternatively, if on the command line, you add the switch
'/AB', then the first file save will result in a binary file
append.
Note that, if you have multiple files open, then the binary
file will be appended to the first one saved.
Also, note that if the text file has not been modified, then
no appending takes place. If the <F10>FA option was used,
then editing continues if the current window has not been
modified.
@pa
@tc1Decoding a file
Decoding a file
Decoding (or extracting) of a binary file takes place either
if you add the switch '/BC' to the command line when invoking
EasyEdit
eg EE TEST.BIN /BC [RET]
or if you edit the file and use the <F10>WE option to extract
the file. Note that this option only works if the cursor is
in the window with the binary data.
If the file contains an encoded binary file, it will be
extracted. You will be given the chance to change the file
name or directory before it is written. Also, you will be
given the opportunity to abort or continue if a file of the
same name already exists. After the extraction, EasyEdit
exits, if you used the '/BC' option, since it is assumed you
do not want to view the encoded data.
If you DO wish to view the file, just edit it as normal.
Please do NOT attempt to change the data. I have put in
rudimentary checking but it is easily fooled. You have been
warned......
@pa
@tc0Notes on File Locking
Notes on File Locking
---------------------
EasyEdit has a rudimentary file locking capability. This is
NOT true MS-NET file locking but a quick way of checking if
another user has a file opened for editing with EasyEdit.
It works as follows:
If a user wants to open a file, a file with the same name
but with an extension of '&%&' is created to act as a
lock for other users. When the next user tries to access
that file, EasyEdit will spot the .&%& file and display
an error message accordingly.
The exception from this is that Block Reads are allowed
on any file and, of course, you can still edit the same
file many times in different windows.
I could not use the conventional file/record locking method
because multi-tasking shells such as Desqview (tm) ignore
them and I needed to cater for that.
NOTE WELL:
The point to be aware of is that EasyEdit checks for a file
with the same name as that being edited and extension of &.&
Thus, if you try to edit two files with the same name but a
different extension in the same directory (eg EE.PAS and
EE.ASM) then the second file read will fail if FILELOCK is on.
In this case, turn file locking off or edit the files one at
a time.
@pa
@tc0Notes on Column Mode.
Notes on Column Mode.
---------------------
1. All copies take place in overstrike mode. This has to be done because I
had to allow for the option of the user copying columns to the left of the
text to be copied and overlapping horizontally.
eg The text to be copied is in a block as follows:
┌───────┐
1 2 3 4 │6 7 8 9│q w e r
1 2 3 4 │6 7 8 9│q w e r
a b c d │f g h i│s t u v
a b c d │f g h i│s t u v
└───────┘
If we copy to the left, we should end up with:
┌───────┐
6 7 8 9 │6 7 8 9│q w e r
6 7 8 9 │6 7 8 9│q w e r
f g h i │f g h i│s t u v
f g h i │f g h i│s t u v
└───────┘
If we then copy in INSERT mode to the left we will end up with:
┌───────┐
6 7 8 9 │1 2 3 4│6 7 8 9
6 7 8 9 │1 2 3 4│6 7 8 9
f g h i │a b c d│f g h i
f g h i │a b c d│f g h i
└───────┘
And if we copy to the left and one column down in insert mode we will get:
┌───────┐
│6 7 8 9│q w e r
6 7 8 9 │1 2 3 4│6 7 8 9
1 2 3 4 │a b c d│f g h i
a b c d │a b c d│f g h i
a b c d └───────┘
As you can see, its not easy to overcome this, so I decided to ignore the
problem. It was in theory possible to copy it all to a buffer and then
copy it back but that limits the size of the columns to be moved.
@pa
2. When you delete a block, it either 'closes the gap' or inserts spaces
according to the insert mode of the window which has the marked block.
This is different from Line mode which always 'closes the gap'.
3. In a block copy, the block markers are left with the original block and
not moved to the new block. This is for the Move command.
4. A Move is a Copy followed by a Delete. This explains (I hope) why the
above is set.
5. The end block marker is set under the current character. This is
different from Line mode where it is set before the current character.
That didn't make sense in Column mode. Toggle between the two modes after
marking a block and you will see the difference.
6. Attribute marking/deleting will not work in Column mode.
7. Block read/write and format are not allowed in Column mode.
@pa
@tc0Notes on using an enhanced keyboard
Notes on using an enhanced keyboard
-----------------------------------
Using the KBD_INST program and setting the ENHANCED variable ON in
EE.CFG, it is possible to have many more keystrokes available to invoke
commands. With an enhanced keyboard in normal mode, the keypad and the
the extra keys perform the same function and the F11/F12 keys do
nothing at all. With the enhanced keyboard set up, you can (for
example), use the extra arrow keys for the up and down movement and set
the arrow keys on the numeric pad to go to the top/bottom of the file.
Within KBD_INST, each key on the middle (or extra) keypad is defined as
"Ex..." [eg ExHome for the Home key]. Where there may be conflict on
the numeric keypad, that is defined as "Kp..." [eg KpEnter for the
keypad Enter key].
The full list of keys you can use is as follows:
On the numeric keypad
Ctrl-Up
Minus (-) Ctrl-Minus
Centre (5) Ctrl-Centre
Plus (+) Ctrl-Plus
Down Ctrl-Down
Left Ctrl-left
Right Ctrl-Right
End Ctrl-End
PageDown Ctrl-PageDown
Home Ctrl-Home
Insert Ctrl-Insert
Del Ctrl-Del
/ Ctrl-/ Alt-/
* Ctrl-* Alt-*
Enter Ctrl-Enter Alt-Enter
On the centre keypad
Home Ctrl-Home Alt-Home
PageUp Ctrl-PageUp Alt-PageUp
Up Arrow Ctrl-Up Alt-Up
Left Arrow Ctrl-Left Alt-Left
Right Arrow Ctrl-Right Alt-Right
End Ctrl-End Alt-End
Down Arrow Ctrl-Down Alt-Down
PageDown Ctrl-PageDown Alt-PageDown
Insert Ctrl-Insert Alt-Insert
Del Ctrl-Del Alt-Del
@pa
Miscellaneous
F11 Shift-F11 Ctrl-F11 Alt-F11
F12 Shift-F12 Ctrl-F12 Alt-F12
Ctrl-0
Ctrl-1
Ctrl-3
Ctrl-4
Ctrl-5
Ctrl-7
Ctrl-8
Ctrl-9
Ctrl-;
Ctrl-.
Ctrl-Tab Alt-Tab
@pa
@tc0Notes on Menu Customisation
Notes on Menu Customisation
@tc1 Introduction
Introduction
EasyEdit now has the ability to allow the user to customise the menu
system to include the commands in any way they wish. Of course, the
default menu settings are always available by resetting one option in
EE.CFG, the configuration file.
The user replaceable menu system is controlled by two actions: setting
OWNMENU to ON in EE.CFG and the presence of a file EEMENU.CFG in the
local or global support path. If both conditions are satisfied, the
menu file is read in and interpreted and the new menu structure is
built.
@tc1File Structure
File Structure
The following is the format for EEMENU.CFG. This format MUST be obeyed
or the program will not function correctly. I have included rudimentary
checking but nothing is foolproof.
Each menu has a menu level. There can be a maximum of 3 levels. Each
level starts with a string of six numbers, all integers, separated by
commas, on one line as follows:
Level, Xpos, Ypos, Xsize, Ysize, Items
where:
Level The level number (1 to 3)
Xpos The starting X position for that menu (not including border
characters)
Ypos The starting Y position for that menu (not including border
characters)
Xsize The length of the menu (No of characters across)
Ysize The depth of the menu (No of lines down)
Items The number of menu items in that menu (Max 20).
For each 'item', in the menu, you will need the following:
Command, Offset,menu type, Highlight Offset, label
where:
Command The command number as defined in COMMAND.LST
Offset Offset from the top left X or Y position
Menu Type 0 is an ordinary menu item
1 has a Boolean (ON/OFF) after it
2 has a number after it
3 has some text after it
Highlight The offset into the text for the highlight
character
Label A label describing the menu item. Max of 20
characters is used.
@pa
@tc1Notes
Notes
For Command number, if a menu item leads to a sub menu, it can have
either the number 193 or the number 194. 194 means the menu is
accessible with no file open; 193 means it is NOt accessible with no
file open.
Level 1 menus are always horizontal and there should only be one of
them. Level 2 and 3 menus are always vertical and there can be any
number of them.
If a line begins with a semi-colon (;), it is ignored. This is so
comments can be inserted into the file.
If you want to use the EDLAST ON option, then there must be a FILE
OPEN menu option.
If you want to use the READROW ON option, then there must be a GOTO
LINE/COLUMN/PAGE and OPTIONS LEFT/RIGHT/TOP/BOTTOM/PAGE menu options.
If a menu has sub-menus, and not all items in that menu have
sub-menus, then there must be 'place-holders' in the menu file. This
is a sub-menu with no items in it.
For Network users: EasyEdit attempts to find a menu file in the Local
support path first (EELPATH). If there is not one, it then looks in
the global support path (EEPATH) for the file. Thus, each user in a
network can have customised menus with a global (company) one for
backups.
If EasyEdit detects an error in the file, it exits displaying the
portion of the line where it had an error.
I have provided two files as examples. The first one, GOODMENU.CFG is
a copy of the built-in menu system. The second one EEMENU.CFG is an
example of changing things around. It has Exit and Quit as top level
items, the Block commands are within the Window menu and there are
many other changes.
Please feel free to modify these files to suit your own environment.
@pa
@tc0EasyEdit as a TSR
EasyEdit as a TSR
@tc1 Introduction
EasyEdit has the ability to remain resident in memory, available at
the press of a key, even if you are in the middle of another
application. This is known as TSR mode (Terminate and Stay Resident).
EasyEdit has two forms of TSR mode; swappable and non-swappable.
In swappable mode, most of the code is swapped out to disk or EMS
memory when the program is first loaded, leaving a 6Kb stub in memory.
This means that most of your memory is available for other
applications. When EasyEdit is invoked (with the 'hot-key'), the
application you are running is swapped out and EasyEdit swapped in.
When you are finished editing, EasyEdit is swapped out, the previous
application swapped in, and you may resume where you left off.
In non-swapping mode, all of EasyEdit remains resident in memory and
it is therefore quicker to invoke it. However, this takes up a lot of
memory (minimum of 215Kb) which may lead to some applications not
working. This loss of memory is variable and controlled by a
configuration option, SWAPSIZE, in EE.CFG.
Please note that this is NOT multitasking. When EasyEdit is invoked,
any other application is suspended.
Also, this is not compulsory; you can still use EasyEdit in its
'normal' way. You can even use EasyEdit as a 'normal' editor with
another copy resident and thus edit up to 12 files at once.
To set EasyEdit up for swapping, it needs to be started with one of
the TSR command line options (/TS, /NS, /EM, /FA, /K:n). These options
(detailed above) jump to special code which sets up the swap areas and
then exits back to DOS informing you which keystroke will invoke
EasyEdit. After that, just press the 'hot-key' and EasyEdit will start
up over any current application.
Once EasyEdit is invoked, it all works as though it were the 'normal'
version with the following exceptions:
1. The key to return to your previous application is (by default)
<CTRL-F4>. You may reassign this key to another, using KBD_INST.EXE
but do NOT unassign it or assign it to the same keystroke as the
'hot-key'. In either of those cases, you will be trapped inside
EasyEdit and the only way out would be to reboot your PC.
2. The exit, quit and 'Save Binary and Exit' commands do not function
whilst inside the TSR. To exit, save your work and exit using the
TSR exit (<CTRL-F4>).
3. You will not be allowed to unload EasyEdit if any files are
unsaved.
4. You will not be allowed to exit from the TSR if printing is in
progress.
5. You are not allowed to spawn to DOS or run a DOS command from the
TSR.
@pa
@tc1 Technical notes
Technical notes
---------------
Please load any networking software before EasyEdit as a TSR. Any
software loaded afterwards will be swapped out when EasyEdit is
invoked by the 'hot-key'. Thus communications may be lost when you are
editing.
For PCSA users, the LAT program, used by programs such as SETHOST,
creates pointers into the calling program. If this calling program is
then swapped out, the LAT program may dump data into the middle of
EasyEdit. The SETHOST program is OK since EasyEdit will not swap over
the top of it (thats the advantage of working for Digital!), but I
cannot vouch for other programs.
EasyEdit, in TSR mode, monitors the following interrupts:
05H - Print Screen
08H - Clock Tick
09H - Keyboard
13H - Bios Disk Read/Write
16H - Bios Keyboard
25H - Dos Disk Read
26H - Dos Disk Write
28H - Dos Multitasking
09H is monitored to watch for your keystroke; 08H and 28H are
monitored for up to 2 seconds after the 'hot-key' has been
pressed, to make sure it is safe to pop up. The others are
watched to make sure they are not in operation when EasyEdit
is invoked.
Do not load EasyEdit as a TSR before Desqview. See above for reasons.
Do not invoked EasyEdit while running any programs that use DOS
Extender technology, especially the 386 versions (Phar Lap etc). They
do odd things like remap memory which can have disastrous effects if
you try and swap it out.
If you do not have EMS memory but can create a 1Mb virtual disk using
extended memory, set the EESPATH parameter to point to it. It will
significantly decrease swapping time.
EasyEdit marks the swap files as SYSTEM and Hidden so they cannot be
accidentally deleted. When EasyEdit is unloaded, the swap files are
deleted. If the PC is rebooted before EasyEdit is unloaded, the files
are left but will be reused the next time EasyEdit is loaded as a TSR.
@pa
When EasyEdit is invoked as a TSR, it does the following:
Check if the graphics mode is the same as when EasyEdit was
loaded. If not, it beeps and exits. Thus, EasyEdit will NOT
pop-up over a graphics program.
Check and save the number of lines on the screen (EGA and VGA
only).
Save the state of the mouse, if loaded. This relies on the
mouse driver supporting functions 15H,16H and 17H. If you had
a warning message when loading EasyEdit as a TSR, the mouse
state will not be saved. Please contact the mouse manufacturer
for a more up to date version. It should be Microsoft version
6 compliant.
Save the screen layout.
Call EasyEdit. Continue editing until <CTRL-F4> is pressed.
Restore screen layout.
Restore the mouse state (if applicable).
Restore the correct no of screen lines.
Swap back to the previous application.
@pa
@tc0Compiling a program
Compiling a program
EasyEdit has the ability to swap itself out, compile a program and
return to editing, where, if it finds any errors in the
compilation, will load in the file (if not already loaded), and
highlight the last error line and displaying the relevant error
message. With all 'C' and 'ASM' compilers, you then get the chance
to move up and down the errors list with one keystroke. This does
not apply to Turbo Pascal since the compiler stops after the first
error.
The current list of supported compilers is :
TPC Turbo Pascal (V5.5 and 6.0)
TCC Turbo C (V2.00)
TASM Turbo Assembler (V2.0)
CL Microsoft C (V5.10)
QCL Microsoft Quick C (V1.01)
MASM Microsoft Assembler (V5.10)
BCC Borlands C++ (V2.00)
To invoke this option, press <ALT-F9> [or whichever key you have
assigned]. This will bring up a menu item as shown here:
╔══════════════════════════Compile Setup ═══════════════════════════╗
║ Go ║
║ Filename G:\TP\EE\CREATE_I.PAS ║
║ Compiler name TPC ║
║ Switches /M ║
║ Next error ║
║ Previous error ║
║ Wait after compile OFF ║
║ Test filename G:\TP\EE\BIN\CREATE_I ║
║ Run test file ║
╚═══════════════════════════════════════════════════════════════════╝
Choose any items to amend in the normal way and then press 'G' to
start the compilation.
Filename: This is, by default, the filename of the current
window. You may change it. If the file is in
memory and has been modified, it is saved before
the compilation starts. If any errors are detected
in the compilation and the file is not already in
memory, then it is read in, unless you already
have 6 windows open.
Compiler name Choose one of the names from the list above. You
may prefix it with a pathname if you wish. If you
choose a compiler which is not on the list, the
compilation will still take place but an error
message will appear when it tries to detect any
errors.
Switches Enter any compiler switches here.
Next error Display the next error which the compiler found. A
maximum of 10 errors are stored.
Previous error Display the previous error which the compiler
found. A maximum of 10 errors are stored.
@pa
Wait after If you are uncertain that the compilation is
taking place, change this option to ON. Before
EasyEdit returns to editing, it pauses and you
press any key to continue. Thus, you can inspect
the output that the compiler produces.
Test filename To test the program you have compiled, enter its
name or the batch file that calls it here.
Run test file To run the test, choose this option. The 'Wait
after Compile' option also works here.
@pa
@tc0Command Summary
Command Summary
---------------
This section outlines the DEFAULT keyboard layout. If you have
used KBD_INST to modify any keys, then the keymapping to commands
in this section could be invalid. The command list is in the same
order as shown in the KBD_INST program.
Command name Default keystroke Description
------------ ----------------- -----------
Left Character <Left-arrow> Move the cursor one character
left. If you are at the left most
column (Col 1) and the LEFTUP
option is ON, then the cursor
wraps back to the end of the
previous line.
Right character <Right-arrow> Move the cursor one character
right. You may extend beyond the
apparent end of the line without
fear of wrapping round to the
beginning of the next line.
Left one word <Ctrl-Left-arrow> Move the cursor to the beginning
of the previous word. A word
delimitor is any character that
is NOT an alpha-numeric one.
Right one word <Ctrl-Right-arrow> Move the cursor to the
beginning of the next word. A
word delimitor is any character
that is NOT an alpha-numeric
one.
Up one line <Up-arrow> Move the cursor up one line in the
same column.
Down one line <Down arrow> Move the cursor down one line in
the same column. You may not go
beyond the last line in the file.
Scroll up <Ctrl-Z> Scroll the display one line up,
keeping the cursor at it's current
location. If the cursor reaches
the top of the screen, it will be
moved down one line.
Scroll down <Ctrl-W> Scroll the display one line down,
keeping the cursor at it's current
location. If the cursor reaches
the bottom of the screen, it will
be moved up one line.
@pa
Down page <Pg-Down> Move the cursor to display the
next screen. The number of lines
moved depends on the window size.
Up Page <Pg-Up> Move the cursor to display the
previous screen. The number of
lines moved depends on the window
size.
Top of file <Ctrl-Pg-up> Move the cursor to the beginning
of the file.
Bottom of file <Ctrl-Pg-Down> Move the cursor to the end of the
file.
Left of Line <Home> Move the cursor to column one of
the current line. If AutoIndent is
ON, the cursor will first move to
the first character on the line,
then to the beginning of the line.
Right of line <End> Move the cursor to the last
character on the current line.
Top of screen Move the cursor to the top of the
screen in the current column.
Bottom of screen Move the cursor to the bottom of
the screen in the current column.
Go to line 'n' <Ctrl-J L> Move to line number 'n'. A window
will open with the current line
number in it. Enter the line to go
to. A '+' or '-' in front of the
number indicates the number is
relative to the current line.
Go to column 'n' <Ctrl-J C> Move to column 'n' on the current
line. A window will open with the
current column in it and you may
enter the new one. A '+' or '-' in
front of the number indicates the
number is relative to the current
position.
Go to Page 'n' <Ctrl-J P> Move to page 'n' if pagination is
ON. Displays an error if
pagination is OFF.
Goto Window 'n' <Ctrl-J W> Go to window 'n'. A list of
available windows will be shown;
choose one in the normal way.
Goto top block <Ctrl-Q B> Go to the start of a marked block.
Goto end block <Ctrl-Q K> Go to the end of a marked block.
@pa
Jump to marker <Ctrl-Q n> Jump to marker 'n'. 'n' must be
between 0 and 9 and previously set
Set marker <Ctrl-K n> Set marker 'n'. A highlight will
be displayed at the current cursor
position and you can use the Jump
to Marker command to return to it.
Cancel it by setting the same
position again.
Previous position <Ctrl-Q P> Move the cursor to its previous
position.
Up equal indent <Ctrl-J B> Move up to the next line whose
first character is at the same
column as the current line.
Down equal indent <Ctrl-J E> Move down to the next line whose
first character is in the same
column as the current line.
Next Sentence <Ctrl-Q Z> Move to the beginning of the next
sentence.
Prev Sentence <Ctrl-Q W> Move to the beginning of the
previous sentence.
New Line <Ctrl-M> Insert a line break before the
current cursor position. If indent
is ON, position according to the
previous line
Insert Line <Ctrl-N> Insert a line break after the
current cursor position. If indent
is ON, position according to the
previous line
Insert Ctrl char <Ctrl-P> The next character typed after the
<Ctrl-P> will be inserted into the
text and not interpreted in any
way. Very useful for inserting
escape sequences into text.
Delete char <Del> Delete the character underneath
the cursor and move characters to
close the gap if in Insert mode.
Delete prev char <Backspace> Delete the character to the left
of the cursor position. If the
cursor is at column 1, join the
current line to the previous
line. If in insert mode, close
the gap. Note that this command
will NOT delete any attribute
markers. Use the <Del> key or the
<F10>TAD command to delete
attribute markers.
@pa
Delete word right <Ctrl-T> Delete the word to the right of
the current cursor position.
Delete to EOL <Ctrl-Q Y> Delete all characters from the
current cursor position to the end
of the line.
Delete line <Ctrl-Y> Delete the current line and move
it to the delete buffer.
Delete line no undo <Ctrl-Q T> Delete the current line but do not
move it to the delete buffer.
Find <F3> Find text. See the menu text for
further description.
Find and replace <Ctrl-F3> Find text and replace with other
text. See the menu text for
further description.
Search and apply macro <Ctrl-Q M> Search for text, and if found,
playback the selected macro. See
the menu text for further
descriptions.
Find Next <F4> Continue the search using the
previous text string. See the menu
text for further descriptions.
Edit New file <Ctrl-F2> Edit another file in the current
window. You will be given the
option to save the current file if
it has been modified.
Abandon file <Shift-F2> Clear the current window. If the
file has been modified, you are
given an opportunity to save it
first. Press <ESC> to continue
editing.
Read file <Shift-F8> Read a file into the current
window merging it with the current
text immediately before the
cursor. See the menu option for
more details on this.
Write block <Shift-F7> Write the currently marked and
highlighted block to a file. See
the menu option for more details
on this.
Save file <Ctrl-F10> Save the current window to a file
and continue editing.
Save/edit new <Shift-F10> Save the current file if modified
and open a new file in the current
window.
@pa
Save/exit <Alt-F10> Save the current file, if modified
and exit to DOS.
Save to name <Ctrl-K N> Save the current window to another
file.
Open new file <F2> Open a new or existing file into a
new window on the screen. If the
filename is the same as an
existing edit, the windows will be
'linked' and any actions in one
will be repeated in another.
Close file <Alt-F2> Close the current window. If the
file has been modified, you will
be given an opportunity to save
it.
Next window <F6> Move the cursor into the next
window. If zoom is ON, the next
window will appear full screen
otherwise, the cursor will appear
at the other window. Row and
column positions are preserved
between windows.
Previous Window <Alt-F6> Go to the previous window.
Counterpart to the <F6> command
above.
Resize window <Ctrl-O S> Resize the current window. See the
menu option for more details.
Toggle window zoom <F5> Zoom the current window to full
screen if not zoomed or, return to
the previous state if the window
is zoomed. An indicator on the
status line will show if the
window is zoomed.
Set Block begin <F7> Mark the beginning of a block of
text. When both top and bottom
positions have been marked, the
text is highlighted.
Set Block end <F8> Mark the end of a block of text.
Copy Block <Alt-F8> Copy the currently marked and
visible block to immediately
before the cursor.
Move Block <Alt-F7> Move the currently marked and
visible block to immediately
before the cursor.
@pa
Delete Block <Ctrl-F7> Delete the currently marked and
visible block. See the menu option
for more details on this.
Hide block display <Ctrl-F8> Turn the block highlight OFF. Many
block commands are only executed
when the block is highlighted
(visible).
Mark current word <Ctrl-K T> Make the current word a visible
block.
Macro record <Ctrl-J T> Toggle macro recording ON or OFF.
See the menu option for more
details of this.
Insert scrap (prompt) <Ctrl-J I> Insert the scrap macro 'n' times.
You will be prompted for the
number of times to insert (play
back) the macro. See below for
size limits.
Insert scrap 'n' times <Ctrl-J n> Insert the scrap macro 'n' times
See below for size limits
Insert Macro 'n' <Alt-n> Insert (playback) macro 'n'. 'n'
must be between 1 and 9. Note that
the size of the macro will affect
how many times it can be played
back. The total number of
characters that can be played back
at once is 254. If a macro is
greater than half that, it can
only be played back once. If less
than half, then the number of
times is the size relative to the
maximum. See the menu option for
more details.
Insert Macro (prompted) Insert (playback) a macro. A
window will open with the existing
macros listed. Choose one in the
normal way. If you have macro
substitution characters, the
relevant ones will be inserted.
See the menu option for full
details.
Edit Macro Edit a macro. See the menu option
for more details.
Load a macro file Load in a new macro file. See the
menu option for more details.
Save a macro file Save a set of macros to a file.
See the menu option for more
details.
@pa
Toggle Insert <INS> Toggle between Insert and
Overstrike mode for the current
window. This option can be saved
with the <F10>OS command.
Toggle Autoindent <Ctrl-Q I> Toggle autoindent mode for the
current window. When ON, all new
or wrapped lines will have the
left margin set to the same as the
previous line. when OFF, the left
margin will be set to the menu
item ( <F10>OML ).
Toggle Word Wrap <Ctrl-O W> Toggle the wordwrap mode for the
current window. When ON, any text
written beyond the right margin is
automatically wrapped to the next
line. When OFF, editing can
continue up to column 999.
Toggle Justification <Ctrl-O J> Toggle right justification. Text
will be evenly divided along the
current line between the left and
right margin to give an even look
to the text. The 'current margin'
is defined as the text between the
right margin and either, the left
margin or, if AUTOINDENT is ON,
the left margin of the line above.
Toggle compression Toggles space compression before
wrapping text. Normally all
extraneous spaces are removed
before a line is wrapped. By
turning this option OFF, columns
of text will be preserved.
However, justification will be
turned OFF by this.
Set left margin <Ctrl-O L> Set the left margin for the
current window. See the menu
option for more details.
Set right margin <Ctrl-O R> Set the right margin for the
current window. See the menu
option for more details.
Set temp margin <Ctrl-O G> Set a temporary margin at the
first character of the current
line. The margin is removed when a
[RET] is pressed. The tab display
is modified to show the status.
@pa
Set Margin at cursor <Alt-F3> Set the left margin to the cursor
position. This stays in effect
until the next [RET] is pressed.
Very useful for indenting text.
The tab display is modified to
show the status.
Set margin release <Ctrl-O X> Release the right margin to allow
typing to continue without word
wrap. The right margin is restored
when a [RET] is pressed. The
status line is updated to show
this.
Centre line <Ctrl-O C> Centre the current line between
the left and right margins.
Toggle case <Ctrl-O O> Toggle the case of either, the
character under the cursor or, if
a block is marked, visible and the
cursor is within it, the block.
Lower case <Ctrl-O V> Set the case to lower of either,
the character under the cursor or,
if a block is marked, visible and
the cursor is within it, the
block.
Upper case <Ctrl-O U> Set the case to upper of either,
the character under the cursor or,
if a block is marked, visible and
the cursor is within it, the
block.
Reformat <Ctrl-B> Reformat the current paragraph so
it fits within the current left
and right margins. Autoindent and
compression are accounted for.
Reformat block <Ctrl-K F> Reformat the marked and visible
block as above. Blank lines are
taken as paragraph markers.
Toggle tab display <Ctrl-O T> Toggle the display of tab
characters at the top of the
screen. It only affects the
display, not the tabs.
Toggle mark display <Ctrl-K M> Toggle the display of text markers
Toggle page display <Ctrl-O B> Toggle the display of pages on the
screen.
Toggle attribute display <Ctrl-O D> Toggle the display of
attributes as colours or
control characters. See the
menu option for more details.
@pa
Toggle help display <Ctrl-J K> Toggle the display of short-cut
keystrokes when in the menu system
Invoke DOS shell <Shift-F6> Execute a DOS command. Press [RET]
for a DOS shell. See the menu
option for more details on this.
Change dir <Ctrl-J D> Change to a new drive or directory
See the menu option for more
details.
Get Info <Ctrl-F1> Get info on current file. See the
menu option for more details on
this.
Show memory <Shift-F1> Show the available free memory.
Directory Get a directory listing of the
current or any other directory.
See the menu option for more
details.
The following are all menu commands with no default keystroke. See the
menu option for further descriptions.
Set undo limit
Set Path
Set extension
Set colours
Toggle Snow control
Toggle block cursor
Toggle 43/50 line mode
Toggle Tab expansion on read
Toggle Tab writing
Toggle high-bit stripping on read
Set High bit stripping on read These two options set or
Unset high bit stripping on read unset the action no matter
what the state of the
toggle
Toggle default zoom state
Save all defaults
Tab <TAB> Move the cursor to the next tab
stop (either fixed or smart)
inserting spaces or tab characters
if appropriate.
Back-Tab <Shift-Tab> Move the cursor to the previous
tab stop (fixed only).
@pa
Toggle fixed tabs <Ctrl-O T> Toggle between using fixed tabs
and 'smart' tabs. When smart tabs
are ON, the tab settings are taken
from the first character in each
word on the line above the current
one. Thus, the tab display is
irrelevant and is toggled OFF.
Edit tabs <Ctrl-O F> Edit the tabs interactively. See
then menu option for more details.
Set tabs <Ctrl-O I> Set the tab stops according to the
word spacing on the current line.
Write tabs Write a representation of the tab
settings into the text. This can
be used later to set the tabs (see
above).
Set tab size Set the fixed tab spacing.
Restore fixed tabs Restore tab settings to the even
spacing.
Print a file <F9> Print a text file in the
background. If printing is already
taking place, a status window will
display the file, the output
device and the page being printed.
Otherwise, a menu will appear and
you may choose various options for
printing. See the menu option for
more details on this.
The following are all menu commands with no default keystroke. See the
menu option for further descriptions.
Set top margin
Set bottom margin
Set page length
The following are all attributes which can be set for the text. When
the file is printed by EasyEdit, any attribute will be converted to
the appropriate print command string using the printer definition
table.
Set Bold <Alt-B> If a block is marked and visible,
it will be set bold. Otherwise, a
pair of 'bold' markers will be
inserted in the text and the
cursor positioned between them.
Any text entered there will have
the bold attribute
Set DoubleStrike <Alt-D> As above but for doublestrike.
Set Underline <Alt-S> As above but for underline.
Set Superscript <Alt-H> As above but for superscript.
Set Subscript <Alt-L> As above but for subscript.
Set Compressed <Alt-C> As above but for compressed mode.
@pa
Show Attribute <Ctrl-J F> If the cursor is positioned over
an attribute marker (shown in top
right of status line), a
description of the attribute will
be shown at the top of the screen.
Delete Attributes Any attribute markers within a
marked block are deleted.
Help <F1> When editing, displays a window
with the help topics in. Choose
one using the arrow keys and press
[RET].
When actioning a menu item, or
entering information into window
boxes, the help will relate to
that specific item - known as
context-sensitive help.
Help summary <Ctrl-J H> Display a summary of how to use
the help system.
Key Help <Shift-F5> Display help on the function keys
Other help is accessed through the Main help display.
Menu <F10> Activate the menu system.
Abort command <Ctrl-U> Abort any incomplete command.
Undo last deletion <Ctrl-Q U> The last 20 lines deleted are
saved in a delete buffer. This
command restores the last line
deleted and removes it from the
delete buffer.
Restore Line <Ctrl-Q L> Restores the line to its state
when the cursor first entered it.
If you move the cursor off the
line, this command has no effect.
Insert undo buffer <Ctrl-Q V> Insert the entire undo buffer at
the cursor.
Flush undo buffer <Ctrl-Q J> Clear out the undo buffer.
Draw box <Alt-F5> Toggle box drawing ON or OFF. See
the text above for more details on
this.
Toggle line drawing <Alt-F4> Toggle line drawing ON or OFF. An
indicator appears on the status
line to show if line drawing is
ON. See the text above for more
details on this.
@pa
Expand abbreviations <Alt-T> Expand the previous 1-3 characters
based on the abbreviations file.
See above for details.
Check Spelling Perform a spelling check if Turbo
Lightning is installed or the user
dictionary is found.. See the menu
option for further details.
Append a binary file Append a binary file to the text.
See above for further details.
Word count current buffer Display a window containing the
number of words in the current
buffer.
Extract a binary file Check for and, if found, extract a
binary file from the file
currently being edited.
Do Command <Ctrl-F6> Perform a set of commands many
times. See below for more details.
Find matching pair <Shift-F3> Find the matching pair as defined
in the file EE.MCH. See below for
more details.
Add macro file comment Add a comment to a macro file.
Toggle Block Line/Column mode Toggle between working on lines
of text and columns of text with
the block functions.
Make a window read-only Make the current window read-only.
This means that any modifications
done will not be saved.
Make a window read-write Makes the current window writable.
Any modifications done will be
saved as long as the indicator '*'
is seen in the status line.
Find next word at cursor Find the next occurence of the
word underneath the cursor. See
the menu option for further
details.
Toggle single key select <ALT-F1> If not set, turns on single key
block selection. Then, cursor
movement will automatically set
the block highlight. Press it
again to anchor the block.
Next paragraph Move the cursor to the first
character of the first line of
the next paragraph.
@pa
Previous paragraph Move the cursor to the first
character of the last line of the
previous paragraph.
Toggle out of the TSR <Ctrl-F4> Leave editing and return to the
application which was there before
EasyEdit was invoked with the
hot-key.
Move all windows up <Ctrl-Home> Move all windows up one line.
Move all windows down <Ctrl-End> Move all windows down one line.
Compile a program <ALT-F9> Display a set of menus to compile
a program. See the section on
compiling for more details.
Delete word left Delete a word to the left of the
cursor. If the cursor is under a
word, it will delete that word.
Toggle single/double line When drawing lines, this option
toggles whether single lines of
double lines will be used.
Copy/Delete a file <F10>UF This will allow users to copy or
delete files without exiting EE
first. Files can be selected from
a list.
@pa
@tc0Function key summary
@tc1Alone
Function Key Summary
--------------------
This section summarises the action of each of the function keys.
Obviously, if you have changed these with the KBD_INST program,
please ignore this section.
Key Name Description
--- ---- -----------
F1 Help When editing, displays a window with the help
topics in. Choose one using the arrow keys and
press [RET].
When actioning a menu item, or entering
information into window boxes, the help will
relate to that specific item - known as
context-sensitive help.
F2 Add Window Open a new or existing file into a new window
on the screen. If the filename is the same as
an existing edit, the windows will be 'linked'
and any actions in one will be repeated in
another.
F3 Find Find the occurrence of text. See the menu
option for more details on this.
F4 Find Next Find the next occurrence of text. See the menu
option for more details on this.
F5 Zoom Zoom the current window to full screen if not
zoomed or, return to the previous state if the
window is zoomed. An indicator on the status
line will show if the window is zoomed.
F6 Next window Move the cursor into the next window. If zoom
is ON, the next window will appear full screen
otherwise, the cursor will appear at the other
window. Row and column positions are preserved
between windows.
F7 Mark block begin Mark the beginning of a block of text. It
must be before the end of block marker for
block actions to take place
F8 Mark block end Mark the end of a block of text. It must be
after the begin block marker for block
actions to take place.
F9 Print Print a text file in the background. If
printing is already taking place, a status
window will display the file, the output
device and the page being printed. Otherwise,
a menu will appear and you may choose various
options for printing. See the menu option for
more details on this.
F10 menu Invoke the main menu system. See the menu
option for more details on this.
@tc1Alt
Key Name Description
--- ---- -----------
Alt-F1 Toggle Select Toggle single key block selection.
Alt-F2 Close window Close the current window. If the file has been
modified, you will be given an opportunity to
save it.
Alt-F3 Margin to cursor Set the left margin to the cursor position.
This stays in effect until the next [RET] is
pressed. Very useful for indenting text. The
tab display is modified to show the status.
Alt-F4 Line drawing Toggle line drawing ON or OFF. An indicator
appears on the status line to show if line
drawing is ON. See the text above for more
details on this.
Alt-F5 Box Drawing Toggle box drawing ON or OFF. See the text
above for more details on this.
Alt-F6 Previous Window Go to the previous window. Counterpart to the
<F6> command above.
Alt-F7 Move block Move the currently marked and visible block to
immediately before the cursor.
Alt-F8 Copy block Copy the currently marked and visible block to
immediately before the cursor.
Alt-F9 Compile program Display a set of menus to compile a program.
See the section on compiling for more details.
Alt-F10 Save and exit Save all modified windows and exit to DOS
@pa
@tc1Ctrl
Key Name Description
--- ---- -----------
Ctrl-F1 Get info Get info on current file. See the menu option
for more details on this.
Ctrl-F2 Edit new file Edit another file in the current window. You
will be given the option to save the current
file if it has been modified.
Ctrl-F3 Find & replace Find the next occurrence of text and replace
with other text. See the menu option for more
details on this.
Ctrl-F4 Spare Toggle out of EasyEdit as a TSR and return to
the previous application.
Ctrl-F5 Spare Use as you wish
Ctrl-F6 Do Command Perform a command many times. Enter the
number of times to perform the command,
followed by a '!', followed by the command.
Enter the command the same way as a macro
command. If no '!' is found, the default is
to run it twice.
Ctrl-F7 Delete block Delete the currently marked and visible block.
See the menu option for more details on this.
Ctrl-F8 Hide block Turn the block highlight OFF. Many block
commands are only executed when the block is
highlighted (visible).
Ctrl-F9 Spell check Invoke the spelling checker.
Ctrl-F10 Save/continue Save the current window to a file and continue
editing.
@pa
@tc1Shift
Key Name Description
--- ---- -----------
Shft-F1 Show free mem Show the amount of free memory.
Shft-F2 Abandon edit Clear the current window. If the file has been
modified, you are given an opportunity to save
it first. Press <ESC> to continue editing.
Shft-F3 Find Matching Find the corresponding match to the word
under the cursor - eg begin/end or { }. See
the appendix for more details on this.
Shft-F4 Spare Use as you wish
Shft-F5 Key help Quick help for the actions of the function
keys.
Shft-F6 Dos command Execute a DOS command. Press [RET] for a DOS
shell. See the menu option for more details on
this.
Shft-F7 File block Write the currently marked and highlighted
block to a file. See the menu option for more
details on this.
Shft-F8 Read file Read a file into the current window merging it
with the current text immediately before the
cursor. See the menu option for more details
on this.
Shft-F9 Toggle Line/Col Toggle between Line and Column mode when
working with blocks of text. See the notes
above for further information.
Shft-F10 Save/switch Save the current file if modified and open a
new file in the current window.
@pa
@tc0Menu summary
@tc1Description
Menu Summary
------------
This section explains each menu choice activated by the <F10>
command. If you have used your own menu system, then please
ignore this section.
Each menu choice is followed by the 'accelerator key'; the
shortcut way to choose that option. This shortcut key may have
changed if you have modified the defaults using KBD_INST.
The Menu System is where the power of EasyEdit lies. By using the
options available here, editing files is made very easy.
The menu system is activated by pressing the <F10> function key.
If you have modified this using KBD_INST, the new keystroke will
be displayed in the top right of your screen.
The top of the screen will change to show the top-level menu
system, with the last option selected being highlighted.
You get out of any menu item by pressing the <ESC> key.
An example is displayed below
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚══════════════════════════════════════════════════════════════════════════════╝
To select a menu option either:
Move the highlight to the item using the arrow keys and press
[RET] (the highlight will 'wrap around' if you press it too many
times)
or
Press the letter corresponding to the first letter of the menu
item (usually highlighted)
NOTE
----
a. If there are no open windows on the screen, the menu choice is
restricted to those items which are relevant.
b. When you select an option from the main menu, a submenu will
appear. Choose an item in exactly the same way.
c. If you are choosing an option for the second or subsequent
time, EasyEdit 'remembers' your last choice and positions the
highlight at that entry.
@pa
@tc1File menu
FILE menu
---------
This controls a lot of the file routines.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚╦═════════════════╦═══════════════════════════════════════════════════════════╝
║ Open.. ║
║ Close ║
║ Save ║
║ Write to.. ║
║ Print.. ║
║ Get info ║
║ Exit ║
║ Add Binary/exit ║
║ Quit ║
╚═════════════════╝
@tc2Open
A) Open <F2>
This option allows you to read a file into a NEW window. It
will prompt you for a filename, read in the file and position
the cursor according to the .R_C file (if found). If the
previous window was Zoomed, then the new window will be
zoomed.
@tc2Close
B) Close <Alt-F2>
This option will close the current window. If the file had
been modified, you will be given an opportunity to save it
first. If it is the last window on the screen, you will be
returned to the menu system.
@tc2Save
C) Save <Ctrl-F10>
This option allows you to save your current editing and
continue working. The .R_C file is also updated at this time.
@tc2Write to..
D) Write to ... <Ctrl-K N>
This option allows you to write the current file to a new
filename. You will be asked for a new filename. If it already
exists, you will be asked to confirm that it is OK to
overwrite it. The .R_C file is updated at this time and the
current editing window will show the new filename.
@pa
@tc2Print
E) Print <F9>
A window will be presented similar to the one below. You need
to set all the items correctly and then press 'P' or select
the 'Print file now' option to start printing. If you are
printing the file being edited, it will be saved first if it
has been modified,before printing takes place. Look at the
modified flag '*' at the top of the screen to verify if it
needs saving first.
Printing takes place in the background so you may continue
editing after starting the print off. A symbol <P> at the top
right of the screen indicates that printing is taking place.
To abort printing, choose the print option again and answer
'Y' to the 'Abort ?' command.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚╦═════════════╦═══════════════════════════════════════════════════════════════╝
║ Open.. ║
║ Close ║
║ Save ║
║ Write ╔═══════════════════════════ Print Setup ═══════════════════════════╗
║ Print.║ Print file now ║
║ Get in╠═══════════════════════════════════════════════════════════════════╣
║ Quit ║ Name of file ║
╚═══════║ Which printer PLAIN.PDF ║
║ Device LPT1 ║
║ Copies 1 ║
╠═══════════════════════════════════════════════════════════════════╣
║ Auto formatting ON ║
║ First page 1 ║
║ Last page 4095 ║
║ Offset 0 ║
║ Manual paper feed OFF ║
║ Use formfeeds OFF ║
║ Edit printer codes ║
║ Save printer setup ║
║ Both, Odd or Even Both ║
╚═══════════════════════════════════════════════════════════════════╝
@tc3Print
a) Print file now
Select this option when all the other options are correct
and the file has been saved.
@tc3Name
b) Name of file
The default is the file in the current window. If you wish
to change it, you will be presented with a window in which
to enter the new file name. The usual editing rules apply
here.
@pa
@tc3Printer type
c) Which printer.
EasyEdit can print to a variety of printers controlled by
a printer definition file (.PDF extension). This option
allows you to choose which printer codes will be sent to
the printer. The name of the .PDF file is saved with the
<F10>OS option. At the same time the .PDF file is chosen,
a character translation table file will be opened if
present. See the appendix for more details.
@tc3Device
d) Device.
EasyEdit can print to any Dos device (LPT1-3, COM1-2) or
to a file. You select which one here. You will be
presented with a menu choice. Use the arrow keys to select
the correct option and press [RET]. If you choose a file,
you will be asked for the output filename. All printer
codes will be converted according to the printer type.
@tc3Copies
e) Copies
This option lets you print multiple copies of the same
file without having to repeat the command. It will only
print one copy TO a file. Enter the number of copies to
be printed.
@tc3AutoFormatting
f) Auto Formatting
This is a toggle which you change by pressing [RET]. It
allows you to print files 'as is' or with page formatting.
@tc3First Page
g) First page
Enter the first page you want to print. It must be less
than or equal to the last page.
@tc3LastPage
h) Last page
Enter the last page to be printed. There is a maximum of
4095 pages allowed in one file and you will not be allowed
to exceed that.
@tc3Offset
i) Offset
Enter any left margin offset. This saves you having to
enter the @PO command at the top of your document.
@tc3Paper feed
j) Manual paper feed
This is a toggle - If YES, you will be asked to insert the
next sheet of paper after each page - if NO, printing will
not stop. Press [RET] to toggle the option.
@tc3Form feed
k) Use form feeds
This is a toggle - if YES, the print routine will send a
form feed character to the printer (^L) to move to a new
page - if NO, then the paper will be advanced by multiple
line feeds. Press [RET] to toggle the option. This option
is saved in the .PDF file.
@pa
@tc3Edit printer codes
l) Edit printer codes.
This option allows you to edit the printer codes
associated with an attribute (eg Bold) for the particular
printer.
Each attribute will have two codes: one to turn it ON and
another to turn it OFF.
You will be presented with a menu selection as follows:
╔═ Printer Strings ═╗
║ Initialization ║
║ Reset ║
║ Bold text ON ║
║ Bold text OFF ║
║ Doublestrike ON ║
║ Doublestrike OFF ║
║ Underscore ON ║
║ Underscore OFF ║
║ Superscript ON ║
║ Superscript OFF ║
║ Subscript ON ║
║ Subscript OFF ║
║ Compressed ON ║
║ Compressed OFF ║
║ Italic ON ║
║ Italic OFF ║
║ Comment ║
╚═══════════════════╝
For each option, a window will open and you may enter the
text string associated with each attribute. The
'Initialisation' and 'reset' options take effect on
starting and stopping printing.
To enter 'special' text such as the <ESC> key, press the
SCROLLOCK key first, then the <ESC> key, then SCROLLOCK
again to revert to normal. Press [RET] when finished or
<ESC> to abort the edit.
The 'comment' is used to give more information about that
printer and is displayed when a list of printer files is
shown (if COMMFILE is ON).
@tc3Save printer setup
m) Save printer setup.
This option allows you to save the printer codes to a new
file. This is the mechanism whereby new printer files
(.PDF) are created.
@tc3Both, Odd or Even
n)Both, Odd or Even
This option allows you to print all pages, just even pages
or just odd pages. It works if you select the start and
finish page as well. Thus, you can print to both sides of
the paper by specifying odd pages, then reversing the
paper and specifying even pages.
@pa
@tc2Get info
F) Get info <Ctrl-F1>
This option displays information about the current file being
edited, some environment information and the name and address
of the licensee. Press <ESC> to continue working.
@tc2Exit
G) Exit <Alt-F10>
This option saves any files which have been modified and exits
back to DOS.
@tc2Add Binary/exit
Add Binary/exit
This option asks for a binary file to append, encodes it to
the current buffer (if modified) and then exits. See above for
more information. Note that if the current window has not
been modified, then this option has no effect.
@tc2Quit
I) Quit <Shift-F2>
This option allows you to quit from the editor. If any files
in any window have been modified, you are given an opportunity
to save before exiting.
@pa
@tc1 Block menu
Block commands
--------------
These commands control actions that can be done with blocks of
data. Most of the commands are duplicated with function keys which
is a much quicker way of operating the block commands.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚═════════╦═══════════╦════════════════════════════════════════════════════════╝
║ Begin ║
║ End ║
║ Hide ║
║ Copy ║
║ Move ║
║ Delete ║
║ Write.. ║
║ Read.. ║
║ Format ║
║ Lines ON ║
╚═══════════╝
@tc2Begin
A) Begin <F7>
Set the beginning of a marked block where the cursor lies. If
an 'end block' has already been set and it is below the 'begin
block', the block will be highlighted.
@tc2End
B) End <F8>
Set the end of a marked block where the cursor lies. If a
'begin block' has already been set and it is above the 'end
block', the block will be highlighted.
@tc2Hide
C) Hide <Ctrl-F8>
This will turn the block highlight off. It does NOT hide the
text, only the highlight.
@tc2Copy
D) Copy <Alt-F9>
Copy the current marked block to immediately BEFORE the cursor
position. The new text becomes the marked block.
@tc2Move
E) Move <Alt-F7>
Move the current marked block to immediately BEFORE the cursor
position.
@tc2Delete
F) Delete <Ctrl-F7>
Delete the current marked block. The last 20 lines (default)
of the text are actually moved into the delete buffer so it is
possible to restore them.
@tc2Write
G) Write <Shift-F7>
Write the marked block to a text file. You will be prompted
for a filename and the text will be written out.
@pa
@tc2Read
H) Read <Shift-F8>
Read in a text file (block of text) to immediately BEFORE the
current cursor position. You will be prompted for a filename;
enter '*.*' if you want to choose from a list; and the text
will be read in.
@tc2Format
I) Format <Ctrl-K F>
Format the current marked block. The block must be highlighted
and the cursor must be positioned inside it or an error
message will result.
@tc2Lines
J) Lines ON/OFF <Shift-F9)
This is a toggle to switch between Line and Column mode for
block work.
@pa
@tc1Window menu
Window menu
-----------
This controls the display and sizing of windows on the screen
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚═════════════════╦═══════════════╦════════════════════════════════════════════╝
║ Go to.. ║
║ Zoom OFF ║
║ Previous ║
║ Next ║
║ Resize ║
║ Extract Binary║
║ Read-Only ║
║ Read-Write ║
╚═══════════════╝
@tc2Goto
A) Goto <Ctrl-J W>
This option allows you to select a window from those displayed
on the screen. If only one window is open, nothing happens.
Otherwise, a menu appears with the filename of each window.
Select one by using the arrow keys to move the highlight and
press [RET] or by pressing the number associated with the
window.
@tc2Zoom
B) Zoom <F5>
This is a 'toggle' option. It allows you to expand the current
window to full size, thus hiding all other windows, and return
it to its previous size. An indicator at the top left of the
status screen tells you if the window is 'zoomed'.
@tc2Previous
C) Previous <Alt-F6>
Make the previous window current. The cursor will move into
the previous window and you may continue editing there.
@tc2Next
D) Next <F6>
Make the next window current. The cursor will move into
the previous window and you may continue editing there.
@tc2Resize
E) Resize <Ctrl-O S>
This allows you to adjust the size (number of rows) of a
window in a multi-window display. Use the up and down arrows
to adjust the size and press [RET] when you are ready to
continue editing. [Works great with the mouse].
@tc2Extract Binary
F) Extract Binary
This option will check for, and extract if it finds it, an
encoded binary file from the file in the window you are
currently editing. It looks at the file on disk and ignores
any changes you may have made since you last edited the file.
Before writing the file, the name is presented on the screen.
You may change it to another one at this point. After that,
the filename is checked to see if there is one of the same
name already in existance, in which case, you are given the
chance to overwrite it, and the file is extracted.
@pa
@tc2Read-Only
G) Read-Only
This option will make a window read-only. This allows you to
make corrections to the text of the window knowing it will
never be saved to disk. An indicator '°' (ASCII 248) is
displayed next to the filename. Note that these files will NOT
be 'autosaved'.
@tc2Read-Write
H) Read-Write
This option makes a read-only window writable. This option
will be ignored if the file is read-only on the disk drive.
Note that any amendments made before it was made read-write
will only be saved if the modified indicator '*' is on. You
can force this by entering and deleting one character.
@pa
@tc1Text menu
Text Menu
---------
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚══════════════════════════════╦══════════════════╦════════════════════════════╝
║ Format paragraph ║
║ Temporary margin ║
║ Margin release ║
║ Attribute.. ║
║ Centre line ║
║ Set marker.. ║
║ Restore line ║
║ Undelete ║
╚══════════════════╝
@tc2Format paragraph
A) Format paragraph <Ctrl-B>
This option will format the text from the current cursor
position to the end of the paragraph to make it fit between
the left and right margins. If right justification is ON, the
text will be adjusted by inserting spaces so the right margin
is even and not ragged. If word wrap is OFF, this command will
have no effect (no right margin !).
@tc2Temporary margin
B) Temporary margin <Ctrl-O G>
This option moves the current left margin one tab stop to the
right and remains in force until you finish the current
paragraph (press [RET]).
@tc2Margin release
C) Margin release <Ctrl-O X>
This option allows you to type beyond the current left and
right margins. It is indicated by the words 'Marg Release' on
the status line. You turn it off by selecting that option
again.
@tc2Attribute
D) Attribute
This leads to a further sub-menu where you can select a
text attribute to be applied to the current marked block (if
selected) or, if no block is selected, a pair of attribute
markers will be entered into the text and the cursor placed
between them. See the appendix on attributes for a description
of this process. You can also delete all attributes within a
marked block from this menu.
@tc2Centre line
E) Centre line <Ctrl-O C>
This will centre the current line between the left and right
margins if wordwrap is ON.
@pa
@tc2Set marker
F) Set Marker <Ctrl-Kn>
This option will set a marker at the current cursor position.
You can have up to 10 of these in the text. When you set a
marker, a highlighted number will appear to overwrite the
text; however, it has not deleted anything. You delete markers
by selecting the same marker again at the same place.
If you use the menu system to set a marker, you will be
presented with a list of current markers in use. Select one by
pressing the number associated with the option you require. If
you use the shortcut keys and use existing markers, the old
markers will be deleted automatically.
@tc2Restore line
G) Restore line <Ctrl-Q L>
This option will restore the current line to its original
state when you started modifying it. It will NOT work if you
have moved the cursor to a new line.
@tc2Undelete
H) Undelete <Ctrl-Q U>
When complete lines of text are deleted <Ctrl-Y>, they are
placed on an 'undelete buffer'. You can restore these lines
one at a time with this command.
@pa
@tc1 Goto menu
Goto Commands
-------------
These commands are all concerned with positioning the cursor at a
suitable point in the file.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚═══════════════════════════════════╦═════════════════╦════════════════════════╝
║ Page number.. ║
║ Line number.. ║
║ Column number.. ║
║ Top of file ║
║ Bottom of file ║
║ Marker.. ║
║ Start of block ║
║ End of block ║
║ Next para ║
║ Previous para ║
╚═════════════════╝
@tc2Page
A) Page Number <Ctrl-J P>
If page numbering is ON, you will be presented with a window
in which to enter the page number you wish to go to. Valid
answers are between 1 and 4095. If page numbering is OFF, an
error message will appear on the screen. Press <ESC> to
continue.If you enter a '+' or a '-' before the number, the
cursor will be moved by that amount in the relevant direction.
@tc2Line
B) Line number <Ctrl-J L>
You will be presented with a window in which to enter the line
number. This is always relative to the top of the file whether
page numbering is ON or OFF.If you enter a '+' or a '-' before
the number, the cursor will be moved by that amount in the
relevant direction.
@tc2Column
C) Column number <Ctrl-J C>
You will be presented with a window in which to enter the
column number. Valid answers are between 1 and 999. If you
enter a '+' or a '-' before the number, the cursor will be
moved by that amount in the relevant direction.
@pa
@tc2Top of file
D) Top of file <Ctrl-PgUp>
The cursor will be moved to the top of the file.
@tc2Bottom of file
E) Bottom of file <Ctrl-PgDn>
The cursor will be moved to the bottom of the file.
@tc2Marker
F) Marker <Ctrl-Q n>
Jump to a previously set marker. If you invoke this from the
menu system, a menu of previously set markers will appear and
you can select one of them in the normal way.
You may also use this option to goto a previously set box
marker. This will be the LAST marker displayed in the menu
system.
@tc2Start of block
G) Start of block <Ctrl-Q B>
Jump to the start of a block of data (set with the <F7> key).
The block does not need to be visible.
@tc2End of block
H) End of block <Ctrl-Q K>
Jump to the end of a block of data (set with the <F8> key. The
block does not need to be visible
Hint - The above two commands give you two extra markers
to use.
@tc2Next Paragraph
I) Next Paragraph
Move the cursor to the first character of the first line of
the next paragraph.
@tc2Previous Paragraph
J) Previous Paragraph
Move the cursor to the first character of the last line of the
previous paragraph.
@pa
@tc1Search menu
Search menu
-----------
These commands are concerned with find/replace text options.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚══════════════════════════════════════════════╦═════════════╦═════════════════╝
║ Find.. ║
║ Replace.. ║
║ Use macro.. ║
║ Again ║
║ Next Word ║
╚═════════════╝
@tc2Find
A) Find <F3>
This allows you to search through the text for a specified
word or phrase. Control characters can be included by
preceding them with <Ctrl-P>. You can search for an
end-of-line by including <Ctrl-P><Ctrl-M><Ctrl-P><Ctrl-J>. You
may NOT search for phrases that span lines.
After you have entered the search string, you will be asked
for a letter, or combination of letters, from the list below
to modify the search action. After that, the string will be
searched for and, if found, highlighted until the next
character is pressed.
The options available are:
U Ignore case. Thus, 'EasyEdit' is the same as 'easyedit'.
B Search backwards from the current cursor position. The
default is to search forwards towards the end of the file
W Search whole words only for the search string. Thus, if
the string is 'Easy' then it will NOT be found in
'EasyEdit'.
G Search globally throughout the file starting at the
beginning, no matter where the cursor is.
L Search locally, only within the current marked block.
n Find the nth occurrence of the text. 'n' is an integer.
(n) The found string must start in column n.
(+n) The found string must be at or after column n.
(-n) The found string must be at or before column n.
The last two commands can be combined to produce true
column searches.
Note that the default options can be set using the SEARCHINIT
option in EE.CFG.
@pa
@tc2Replace
B) Replace <Ctrl-F3>
This allows you to search through the file for a string of
letters and replace it with another. Control characters can be
included by preceding them with <Ctrl-P>. You can search for
an end-of-line by including <Ctrl-P><Ctrl-M><Ctrl-P><Ctrl-J>.
You may NOT search for, or replace, phrases that span lines.
After you have entered the search string and the replace
string,, you will be asked for a letter, or combination of
letters, from the list above to modify the search action.
After that, the string will be searched for and, if found,
a window displayed with the text highlighted and 4 options for
you to make:
Y - Make the change
N - Do not make the change but continue on to the next change
A - Make the change and then all further changes.
Q - Do not make the change and quit further searching.
There is one extra search option and one changed option:
N Do not prompt for confirmation as above.
n Make the changes 'n' times - 'n' is an integer.
@tc2Use macro
C) Use macro <Ctrl-Q Enter>
This option will search for a specified string and, if found,
will apply a specified macro to it. This can be very useful
for doing more extensive search/replace functions than is
possible with the standard one. The modifiers are all as
above.
@tc2Find next
D) Find next <F4>
This will use the previous search string and locate the next
one in the same direction as before. It will use the options
as outlined above, except for the 'G' option; find-next will
continue from the current find. If a Find-replace option was
the last one executed, then this command will repeat that. If
a 'Find and execute Macro' command was the last one executed
then this command will repeat that.
If any of the find or find/replace options are repeated, the text
string last used will be displayed. If you wish to use it or
modify it, use the arrow keys to position the cursor. Any other
key will destroy the text to allow new information to be entered.
@tc2Next Word
E) Next Word
This option searches for the next occurence of the word under
the cursor. It uses the default option string (UGB etc) as set
up by the last 'Find' command (or by the SEARCHINIT variable)
and places the word in the Find buffer for subsequent
searches. Be aware that the cursor is positioned beyond the
next occurence of the word so that the 'Find Next' command can
work successfully.
@pa
@tc1Option menu
Option menu
-----------
This menu allows you to change the layout and display of the
Easyedit system. Most of these options can be saved using the
'Save Setup' menu item.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
║ Tabs.. ║
║ Load file options.. ║
║ Display options.. ║
║ comPiler options ║
║ Colours.. ║
║ Save setup ║
╚═════════════════════╝
@tc2Margins
a) Margins..
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
║ Tabs.. ║
║ Load file options.. ║
╔══════════════════╗tions.. ║
║ Left 1 ║ ║
║ Right 70 ║ ║
║ Top 3 ║══════════╝
║ Bottom 3 ║
║ Page length 66 ║
╚══════════════════╝
This leads to a sub menu where you can change the left, right,
top and bottom margins plus the page length (in lines).
You will be presented with a window with a default value
(usually the old value). Enter the new value followed by
[RET]. To exit from the menu system, press <ESC>.
@pa
@tc2Format
b) Format options..
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
║ Tabs.. ║
║ Load file options.. ║
╔════════════════════╗ons.. ║
║ Justify ON ║ ║
║ Word wrap ON ║ ║
║ Autoindent ON ║════════╝
║ Insert mode ON ║
║ Page breaks OFF ║
║ Compress wrap ON ║
╚════════════════════╝
This leads to a sub menu where you can change the following:
@tc3Justify
a) Justify <Ctrl-O J>
This is toggle ON or OFF. Press [RET] to change it. When
ON, all text will be right and left justified between the
current margins by adding spaces between words. WordWrap
must be ON.
The 'current margin' is defined as the text between the
right margin and either, the left margin or, if AUTOINDENT
is ON, the left margin of the line above.
@tc3Wordwrap
b) WordWrap <Ctrl-O W>
This is a toggle ON or OFF. Press [RET] to change it. When
ON, all text will be wrapped at the right margin. When
OFF, text entered will continue up to column 999 if
necessary. [See hint 10. at the end of this manual]
@tc3Autoindent
c) Autoindent <Ctrl-Q I>
This is a toggle ON or OFF. Press [RET] to change it. When
ON, the left margin of a new line will be set to the first
character of the line above. When OFF, the left margin of
a new line will be set to the left margin as defined by
the margins menu.
@tc3Insert
d) Insert <INS>
This is a toggle ON or OFF. Press [RET] to change it. When
ON, all text is inserted, pushing other characters to the
right. when OFF, all text will overwrite other characters.
This does not affect block moves which operate in insert
mode regardless of the status of this toggle.
@tc3Page Breaks
e) Page Breaks <Ctrl-O B>
This is a toggle ON or OFF. Press [RET] to change it. When
ON, the page breaks will be displayed in a column at the
left of the screen and constantly updated in background
mode. All text is pushed one character to the right. When
OFF, page breaks are not displayed or calculated.
@pa
@tc3Compress wrap
f) Compress Wrap
This is a toggle ON or OFF. Press [RET] to change it. When
ON, all extra spaces on a line between the left and right
margins will be removed before word wrap takes place. When
OFF, this will not happen. This can be very useful for
preserving columns of figures for example.
@pa
@tc2Tabs
c) Tabs
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
║ Tabs.. ║
║ Load file options.. ║
╔═══════════════════╗ions.. ║
║ Set tabs ║ ║
║ Put tabs ║ ║
║ Restore even ║═════════╝
║ Edit tabs ║
║ Display tabs ON ║
║ Fixed ON ║
║ Tab size 4 ║
╚═══════════════════╝
This option leads to a submenu where tabs can be adjusted.
This is very powerful and can aid enormously in the layout of
a document. There can be a maximum of 40 tab stops on the
line.
@tc3Set tabs
a) Set Tabs <Ctrl-O I>
The tabs will be initialised based on the words on the
current line of text. This can be very useful for columns
of figures etc. Used in conjunction with 'Put Tabs',
different tab settings can be stored and used within one
document.
@tc3Put tabs
b) Put Tabs
The current tab settings are stored within the document as
a line of text. Tab settings can thus be restored using
the 'Set Tabs' option above. Since the line begins with an
'@' symbol, it will not be printed using the Print menu.
However, it is normal ASCII text and can be used as such.
@tc3Restore even
c) Restore even
Tab settings will be restored to an even spacing depending
on the tab size.
@tc3Edit tabs
d) Edit Tabs <Ctrl-O E>
This option allows you to manually enter the tab stops
using the left and right cursor keys to position the
cursor and the space bar to toggle the tabs ON or OFF.
In addition, pressing the <INS> key will add a new tab and
pressing the <DEL> key will delete a tab. Press [RET] when
finished or <ESC> to abort.
@tc3Display tabs
e) Display tabs <Ctrl-O T>
This option toggles the display of tab characters at the
top of the window. It does not affect the use of the tab
key. Press [RET] to toggle between ON and OFF.
@pa
@tc3Fixed tabs
f) Fixed Tabs <Ctrl-O F>
This is a toggle ON or OFF. Press [RET] to change it. When
ON, tab settings are taken from the display at the top of
the page. When OFF, tab settings are taken from the
contents of the line above the current one.
@tc3Tab size
g) Tab Size
This option allows you to set the fixed tab spacing. Enter
any size less than the current work area size (right-left
margin). The tabs will be updated in the current window
when you use the 'restore even' option.
@pa
@tc2Load file options
d) Load file options
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
║ Tabs.. ║
║ Load file options.. ║
╔═══════════════════════════════╗ns.. ║
║ Home directory F:\TP\EE\ ║ ║
║ File extension ║ ║
║ Expand tabs ON ║═══════╝
║ Write tabs OFF ║
║ Strip hi-bit OFF ║
║ Undo limit 20 ║
╚═══════════════════════════════╝
This option leads to a sub menu concerned with options
regarding file loading and saving.
@tc3Home directory
a) Home directory
This is the directory where EasyEdit expects to find its
initialisation files, printer definition files and macro
files. When you select this option, a window opens with
the current directory specification displayed. Edit or
enter a new one and press [RET] to accept it. The option
is saved using the 'Save Setup' item (see below) so this
only needs to be done once.
@tc3File extension
b) File extension.
If you regularly work with the same type of file, you can
enter a default extension here (just the letters) and it
will be added to any file specification when opening new
or existing files.
@tc3Tab expansion
c) Tab expansion
This is a toggle ON or OFF. Press [RET] to change it. When
ON, any tabs entered from the keyboard will be expanded to
the equivalent number of spaces. When OFF, they will be
left as <TAB> characters.
@tc3Write tabs
d) Write tabs
This is a toggle ON or OFF. Press [RET] to change it. When
ON, all sequences of spaces will be translated to tabs
according to the fixed spacing defined by the tab size.
When off, spaces are written out as normal. Note that any
spaces within single (') or double (") quotes will NOT be
translated to tabs. This is for writing program code.
@pa
@tc3Strip hi-bit
e) Strip Hi-Bit
This is a toggle ON or OFF. Press [RET] to change it. When
ON, any character with the high bit set will have it
stripped off when the file is read in. This is to be able
to read in 'wordstar' compatible files. Note that it will
also affect the IBM line drawing characters. When OFF,
this option is disabled. Also any wordstar 'dot' commands
will be converted to Easyedit '@' commands.
@tc3Undo limit
f) Undo limit
This is the maximum number of lines which will be saved
when a line is deleted from the main body of your text
using the 'delete line' or 'delete block' commands.
Further deletions will remove the oldest deleted line from
the delete buffer.
@tc2Display options
e) Display options
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
║ Tabs.. ║
║ Load file options.. ║
║ Display options.. ║
╔══════════════════╗ ║
║ Snow control OFF ║ ║
║ Block cursor OFF ║══════════╝
║ 43/50 line OFF ║
║ Font display ON ║
║ Key help ON ║
║ Zoom state OFF ║
╚══════════════════╝
This section controls the 'look' of the display. A further
sub-menu will appear with the following options:
@tc3Snow control
a) Snow control
If you have a CGA monitor, toggling this option ON will
alleviate the 'snow' problem when the display is scrolled.
@tc4Block cursor
b) Block cursor
The normal cursor is a flashing underline. On some
monitors, noticably LCD ones, this is very hard to see.
Toggle this ON to have the cursor as a non-flashing block.
@tc343/50 line display
c) 43/50 line
This is a toggle for EGA/VGA displays between the normal
25 line display and 43 or 50 line displays.
@tc3Font display
d) Font display. <Ctrl-O D>
This is a toggle to either display the fonts in their
colours or to display the control characters which mark
the sides of each font type.
@pa
@tc3Key help
e) Key help. <Ctrl-J K>
This is a toggle to control the display of the 'keyboard
shortcut' keys when a menu option is shown. Only the
primary key code is shown.
@tc3Zoom state
f) Zoom state.
This is a toggle which controls the initial Zoom state
when files are read in. Toggle it ON to always have full
screen windows; toggle it OFF to have tiled windows. The
state can be dynamically changed with the <F5> key.
@tc2Compiler Options
f) Compiler Options.
This leads to a sub menu for setting the compiler options and
compiling/testing your programs. See the chapter on compiling
above (page 57).
@tc2Colours
g) Colours..
This leads to a display similar to the one below.
The cursor is positioned by the 'colours' window with all the
options displayed in the 'choices' window. Move the cursor up
and down to select the text type to be modified and press
[RET] to select that one. Then, use the arrow keys to move the
'*' to the colour you wish and press [RET] to select it.
Continue in this fashion until all colours are correct and
then press <ESC> to return to the previous menu. The colours
are saved as a default.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚════════════════════════════════════════════════════╦═════════════════════╦═══╝
║ Margins.. ║
║ Format options.. ║
╔══════ Colours══════╗ ║ Tabs.. ║
║ Normal Text ║ ║ Load file options.. ║
║ Marked Block ║ ║ Display options.. ║
║ Window Status ║ ╔═══ Choices ════╗ ║ Colours.. ║
║ Prompt Line ║ ║ ║ ║ Save setup ║
║ Block Cursor ║ ║ * ║ ╚═════════════════════╝
║ Menu Text ║ ║ ║
║ Menu Frame ║ ║ ║
║ Menu Select ║ ║ ║
║ Menu Hilite ║ ║ ║
║ Bold text ║ ║ ║
║ Doublestrike ║ ║ ║
║ Underscore ║ ╚════════════════╝
║ Superscript ║
║ Subscript ║
║ Compressed ║
║ Italic ║
╚════════════════════╝
@pa
@tc2Save setup
h) Save Setup
Most of the options and toggles are saved inside EE.EXE when
you select this option. This includes colours, margins, tabs
and toggles. The colours are also saved in a colour file.
Enter a legal filename when requested or press [RET] to bypass
this portion.
The file EE.EXE must exist in the 'home directory' or the
current directory as defined above.
@pa
@tc1Utilities menu
Utilities menu
--------------
This option has all the utility commands and functions.
╔══════════════════════════════════════════════════════════════════════════════╗
║ File Block Window Text Goto Search Options Utilities ║
╚══════════════════════════════════════════════════════╦══════════════════════╦╝
║ Spelling check ║
║ Macros.. ║
║ Directory.. ║
║ Change directory.. ║
║ Operating system.. ║
║ File ║
║ Help ║
╚══════════════════════╝
@tc2Spelling check
a) Spelling check <Ctrl-F9>
Spell check the document in the current window.
The spelling checker is quite unique in the text editing
world. This one can either use the Borland Turbo Lightning
engine or use its own internal dictionary to actually do the
work. If you don't have Lightning installed and you have not
registered your copy of EasyEdit, an error message is
displayed.
If the internal dictionary is used, all words are assumed to
be lower case and no checking is made on words such as don't
or doesn't. This will change in a future version.
If no block is visible, EasyEdit will check the entire
document FROM THE CURSOR DOWN. If you wish to check the entire
document, position the cursor at the beginning of the document
first (Ctrl-PgUp).
If a block is marked and visible, EasyEdit will check the
spelling only within that block. The cursor does not need to
be within the block but it will be positioned at the end of it
when the spelling check is finished.
At any time, you can press any key to cancel the spell
checking. A prompt box will be displayed for you to confirm
that you wish to cancel the spell checking. Press <Y> to
cancel or <N> to continue.
If a word is mis-spelled, the checking will pause and you will
be presented with a menu with the following options. Select
one in the normal way or press <ESC> to cancel the spell
checking.
a) Skip once.
Move onto the next word, ignoring this one.
b) Ignore for this document
Assume that the spelling is correct for any other
occurrence of this word.
@pa
c) List Lightning sound-alikes.
This lists alternatives in the Lightning dictionary. It
includes words that look similar and sound similar. Choose
one of the words and it will replace the text in question
(or press <ESC> to return to this menu). This option does
not work with the EasyEdit internal dictionary routines.
It is planned for a future version.
d) Edit from the keyboard.
You will be presented with a window with the current word
in it. Edit it as normal (see beginning of manual for
instructions). Press [RET] when finished or <ESC> to
return to this menu. If justification is ON, then the line
will be re-justified.
e) Add to dictionary
The word (lower cased) will be added to a user dictionary
as defined by the UDICT option in EE.CFG. This user
dictionary will be used in all subsequent spelling checks.
f) Mark with "~".
The word in question will be preceded by a '~' (tilde)
character and spell checking will continue. You can then
go back and edit the word later by searching for a '~'
character.
g) Batch mark the rest of the document.
All remaining words in question will be preceded by a '~'.
More information on the Turbo Lightning spell checker is
available when you purchase the product.
@pa
@tc2Macros
b) Macros.
One of the good things about EasyEdit is its ability to save
and replay keystrokes at your command. This is known as the
'macro' facility. A default macro file can be loaded at
startup - see the initialisation file or command line options
for more details.
There is a maximum of 10 macros allowed - however, macro 0
(also known as the 'scrap' macro) is used whenever a new macro
is created. Each macro can have a maximum of 254 keystrokes.
You can extend this by having one macro call another (and of
course, the last macro can load in a new macro file).
@tc3Load macros
a) Load macros
This option allows you to load in a new set of macros.
You will be presented with a window with '*.MAC' as the
default filename. Enter the name of the macro file you
wish to load or press [RET] to select from the available
ones in the current directory. By default, all macro files
have an extension of '.MAC'. You do not need to enter the
extension to the filename.
@tc3Store macros
b) Store macros
This option allows you to save the macros in memory to a
named file. If this is not done, all new macros will be
lost on exit from EasyEdit.
You will be presented with a window in which to enter the
filename. You do not need to enter an extension.
@tc3Playback macros
c) Playback macros <Alt-n>
This option is for playing back previously created macros.
A window will open showing the names of all the currently
loaded macros. Select one by pressing its number of using
the cursor keys to move the highlight and press [RET]. The
macro will be executed and you will be returned to editing
your document.
The 'shortcut' key is ALT-n where 'n' is a number between
0 and 9.
@pa
@tc3Record macros
d) Record <Ctrl-J T>
This is a toggle to turn ON and OFF macro recording. When
this option is selected, all keystrokes following, until
the next time this option is selected, are stored in the
scrap macro. When you have finished, you will be asked to
enter a number for the macro. The titles of all existing
macros, plus blank spaces where no macro exists, will be
displayed for reference and you may choose one in the
normal way. An editing window is then opened for you to
enter a title for that macro. When macro recording is ON,
an indicator (>R<) appears at the top right of the status
line.
@tc3Edit macros
e) Edit
This option allows you to edit an existing macro. You will
be asked to select a macro from the list and then allowed
to edit its title. After that, a window will open with the
keystrokes displayed. All normal keys are displayed as
they are entered - function keys are displayed enclosed in
angle brackets '<>' with a representation of the
keystroke (eg <Ctrl-F10> or <Alt-8>).
You may use the normal cursor movement keys to position
the cursor at the editing point and then insert, delete or
change as you wish. Press [RET] when editing is complete.
Press Ctrl-Backspace to clear the current macro.
If you wish to enter any key into the macro that would
normally 'do something', press the 'SCROLLOCK' key first.
Any further keystrokes will be inserted until you press
'SCROLLOCK' again. Thus, you may enter [RET], arrow keys
etc into the macro.
Del, Backspace, Ctrl-backspace, Escape, arrow keys and
Enter are the keystrokes concerned.
@tc3Add a file comment
f)Add a file comment
Use this option to add a comment to the macro file. Enter
up to 40 characters. This will be used when displaying
macro filenames in the Load option if COMMFILE is ON.
@pa
@tc3Macro Substitution
Macro substitution
------------------
While editing, you can use certain special characters to
denote that, when the macro is played back, the characters
will be substituted for other things. This facility allows
you to tailor the macros to include such things as the
current date, or a title input at playback time etc.
To invoke the substitution, enter the special character,
ASCII 255 followed by one of the following:
F - The filename in the window which was current when
the macro was started will be put into the macro
at that point.
D - The current date will be inserted into the macro.
T - The current time will be inserted into the macro.
S - Get a string from the keyboard at 'playback' time.
The 'S' must be followed by a string of characters
terminated by ASCII 254. This string will be used
as a prompt in an edit window and whatever you
type in (max 60 characters) will be inserted into
the macro at that point.
E - Replace the string (terminated by ASCII 254) with
the environment variable of the same name.
To get the ASCII characters 255 and 254 into the macro,
you must use the MACRO EDIT facility. Hold down the ALT
key and type the numbers USING THE NUMERIC KEYPAD. Then,
let go of the ALT key. The number will appear in the edit
window as <#255> or <#254>.
Note well: There can only be a maximum of 254 characters
per macro even after all the substitution has
taken place. If substitution takes the macro to
larger than 254 characters, then substitution
is ignored and the macro is inserted 'as is'.
@pa
@tc2Directory
c) Directory...
This option allows you to get a directory listing of the
current (or any other) directory.
A window will open into which you can enter a directory mask
(press [RET] for the whole directory). Wildcards (* or ?) are
permitted.You can then browse up and down the listing using
the arrow keys, the 'home' and 'end' keys and the 'pg-up' and
'pg-dn' keys. Press <Esc> or [RET] when finished.
@tc2Change directory
d) Change directory
You may change the current directory here. An editing window
will open and you can enter the new directory specification.
If you enter a wild card specification (eg C:\TP\*), a list of
all directories in the C:\TP directory will be displayed and
you may choose one in the normal way.
Obviously, the directory must exist.
@tc2Operating system
e) Operating system <Shift-F6>
This option allows you to to execute any DOS command (or
program) as long as there is sufficient memory. An editing
window will open and you may enter the command you wish to
execute. Press [RET] alone to invoke a DOS shell (Type EXIT to
return to EasyEdit in that case).
If the option EMS is set ON, then EasyEdit will swap most of
itself out to EMS giving more memory for the swapped in
application.
One word of warning: Do NOT invoke any TSR (Terminate and Stay
Resident) programs from this command. The system may hang on
you !!!!! TSR's are programs like MOUSE or SIDEKICK. If you
are not sure, ask someone.
@tc2File
e)File
This option will invoke a sub-menu. From here, you may copy a
file or delete a file. If you enter wild-cards (eg *.*), you
can select files from a pull down list.
@tc2Help
f) Help
Get help on the EasyEdit system. A window will open and you
can use the cursor keys to position the highlight on the
option you require help with. You can also press the first
(highlighted) letter of the help description to jump straight
there. Once the help window is opened, you can use the up and
down arrow keys or the <pg-up> and <pg-dn> keys to move
between pages.
@pa
@tc0Appendix
Appendix
--------
@tc1Character Translation Tables
Character Translation Tables
----------------------------
EasyEdit has a unique item amongst text editors (or even most word
processors); up to 64 characters can be translated on printing to
one or more alternative characters. This can be extremely useful
if the printer you wish to use has a different character set for
certain special characters.
Two examples are
a) HP LaserJet uses a different ASCII value for a '£' sign
b) DEC printers have a different way of printing box drawing
characters.
The translation file has the same name as the Printer Definition
File but has an extension of .CHT. It can be created with any text
editor and has the following format:
Col 1 - Character to be translated
Col 2 - Ignored.
Col 3-66 - String of characters to replace the original (max 64).
There can be up to 64 of these translations.
It is loaded automatically when EasyEdit is invoked or when you
change printers using the Print Setup menu option. Be aware that
if you wish to test this, you MUST specify a different name on the
Setup menu or the file is not reloaded (done for speed).
I have provided an example .CHT file which converts the IBM line
and box drawing characters to DEC VT100 special characters. The
file is LA75DEC.CHT and is loaded automatically when you specify
the LA75DEC printer in the Print Setup menu.
There are also other examples provided by users of EasyEdit.
@pa
@tc1Notes on Matching Pairs
Notes on Matching Pairs
This command (Shift-F3 by default) is for the programmers.
One of the hardest things is to find the matching begin/end
pairs in a heavily convoluted program. Now, EasyEdit can do
it for you.
First, you need to set up the file EE.MCH with all the pairs
you wish to look for. I have provided a sample (printed
below).
begin end
{ }
/* */
( )
As you can see, each pair is on one line, separated by a
space. Each item can be up to 10 characters each and there is
a maximum of 10 pairs allowed.
When EasyEdit loads, it looks for EE.MCH in the default home
directory. If found, it loads in the pairs to be used.
To find the matching pair, put the cursor on the word/letter
of one side of the pair and press <Shift-F3>. If there is a
match, the corresponding half will be highlighted.
@tc2Rules and hints:
Rules and hints:
A start pair is defined as the word you want a match for.
The end pair is defined as the word to be searched and matched
eg in BEGIN/END, with the cursor under BEGIN, the start pair
is defined as BEGIN and the end pair is defined as END.
EasyEdit follows the following rules:
1. If the pair half is not one of '{}' or a '[]' or a '()'
then the search is done on WHOLE WORDS only. Thus, if you put
the cursor on 'Begin', then it will not find 'WEND' but will
find 'END'. For the above three cases, search is done on a
character by character basis. So, if the match you want is a
pair such as '(*' and '*)' put the cursor under the '*' and
not the '('.
2. Case is not important.
3. If you put the cursor on the second half of the pair (as
defined in EE.MCH), then the search will be backwards.
Otherwise, the search will be forwards. This can be useful if
you want to find the matching 'begin' to the current 'end'
for example.
@pa
4. Be careful on what is defined as the start pair. For
instance, 'end;' is OK as a word since EasyEdit ignores the
trailing ';' but other combinations may not be OK. I have
tried to cater for all eventualities but if in doubt put
spaces around the start pair.
The end of a word is defined by the following character set
#32,#9,#13,#10,#39,,,.,/,?,;,:,",<,>,[,],{,},-,=,\,+,|,(,),*,%
,@,&,^,$,#,!,~,;];
The reason for the limitation is that EasyEdit needs to have
some way of checking for the end of a word and it does it by
checking the word under the cursor until it meets a character
that is in the above set.
5. If the match doesn't seem right, look for a matching end
pair within a comment. For instance, with a 'begin/end' pair,
its very easy to have a comment such as {this is the end }
and EasyEdit will include that 'end; in its count.
6. In order to find the start pair, EasyEdit does the
following:
If the cursor is at the end of the line, EasyEdit searches
backwards to find the last word.
If the cursor is underneath a word, EasYedit uses that
word.
If the cursor is between words, then EasyEdit searches
forwards to find the next word and uses that as its start
pair.
If in doubt, put the cursor UNDER the word to be used.
I have done limited testing on it and it seems OK. If you do
find any problems, please document them and send them to me.
@pa
@tc1Networking EasyEdit
Networking EasyEdit
EasyEdit has the facility to work well on a network. All
configuration files are opened in Read-Only mode and printing
is terminated properly. It has been tested on both Novell and
PCSA networks (PCSA is Digitals Lan Manager network).
@tc2Installing EasyEdit in a network
Installing EasyEdit in a network
Put all files onto a networked drive.
Set all the configuration options up (hint, use the
'%parameter%' options for any options which the user might
want to change).
Make all files Read-Only (or make the whole drive Read-Only).
At each workstation, set the path and the environment
variable EEPATH to point to the networked drive and set the
EELPATH variable to point to a local directory. Set the other
variables as appropriate.
@pa
@tc1Notes on 'Do Command'
Notes on 'Do Command'
If you wish to enter any key into the command that would
normally 'do something', press the 'SCROLLOCK' key first. Any
further keystrokes will be inserted until you press
'SCROLLOCK' again. Thus, you may enter [RET], arrow keys etc
into the macro. Del, Backspace, Ctrl-backspace, Escape,arrow
keys and Enter are the keystrokes concerned.
You may use the normal cursor movement keys to position the
cursor at the editing point and then insert, delete or change
as you wish. Press [RET] when editing is complete.
When inserting a command a number of times, there is a finite
limit to the maximum number. The internal type-ahead buffer is
1024 characters and the command can only be inserted as many
times as it takes to fill this buffer. Thus, if your command
is 200 characters then it can only be inserted 5 times even
though you may have requested it to be inserted more than
that.
EasyEdit searches for the first '!' and expects a number
before it. If an invalid number is found, the command aborts.
If you have a '!' in the command that you wish to be inserted
in the text and no number at the front (ie, you want it
inserted twice - the default), put a dummy '!' at the front.
This command can be very useful for entering exact numbers of
underlines ('80!-' will do that) or deleting numbers of lines
('20!<Ctrl-Y>' will do that) or other things like that.
@pa
@tc1Hints and tips
Hints and tips
--------------
Not in any particular order, just as I think of them.
1. Printing:
Printing normally takes place in the background at a leisurely
pace whilst other tasks, such as updating the screen, are also
being performed. If you wish to speed up printing, at the
expense of being able to edit at the same time, just press the
<F9> key. A status window will show the current page and
another window will ask if you wish to abort. While this
window is waiting for your input, the only other activity is
printing, so the printing task gets a much greater share of
the CPU and so proceeds faster. The current page is updated
constantly so you can see how fast it's working.
2. Display
Do most of your work with the page display turned OFF. It
makes other background tasks (such as printing) work a little
faster. It does not affect the foreground editing.
3. Windows
Don't work with too many windows. It can get very confusing as
to which window you are in.
4. Status line.
The status line contains a lot of information. The important
stuff is at the left end (Zoom and modified flags, filename)
while the less important information is in the middle. With
multiple windows, it only takes a quick glance at the top left
to work out where you are.
5. Attribute display.
With the font display set to ON, its sometimes hard to see
where a font starts and ends. As a guide, when the cursor is
under a font control character, the cursor shape changes and
an indication of which control character it is, is displayed
at the top right corner of the status line.
6. Please, please read the manual before asking for help. It
should all be in here somewhere.
7. Using the 'initialisation' and 'reset' sequences in the
printer definition tables can greatly enhance the quality of
your output. It makes printing look very professional. As an
example, this manual was printed at 12 pitch with an 8
character offset on a laser printer using the '@' codes at the
top of the file.
8. If you run EasyEdit II on a laptop computer, its sometimes hard
to see where the cursor is. Use the Display Option to set the
cursor to a block and then Save the settings.
9. If you are using a floppy diskette based system, put the EE.EXE
program on a RAM drive; it makes program loading a lot faster.
@pa
10. If you have word wrap set ON and write a continuous line with
no spaces, EasyEdit will appear to run very slow while the
cursor is beyond the right margin. This is due to the word
wrap checking it is doing and is NOT a bug. If it bothers you,
turn word wrap OFF.
11. If, when printing to a slow printer, it seems slow when
editing, look at what type of printer you are using. If it is
serial, it is possible that the printer is suspending
operations until it's buffer is cleared. This affects
everything, not just EasyEdit. Please be patient, its not all
my fault.
12. When printing, a Table of contents file (extension .TOC) is
automatically created. If, at the end of the print, there were
no legal '@TC' commands in the print file, this .TOC file is
deleted. If your system crashes in the middle of a print,
there may be some unexplained .TOC files left. Just delete
them.
13. When inserting a macro a number of times, there is a finite
limit to the maximum number. The internal type-ahead buffer
is 1024 characters and the macro can only be inserted as many
times as it takes to fill this buffer. Thus, if your macro is
200 characters (after all translation), then it can only be
inserted 5 times even though the manual says 'up to 9'.
14. When printing a .TOC file, EasyEdit creates a temporary .TC2
file which is deleted as normal at the end of the print run.
Thus, if you have a normal file which has a .TOC extension,
it can be printed.
15. Use the '%parameter' in EE.CFG for any option which you may
frequently change. Its easier than re-editing EE.CFG each time
16. I have included many macro files and printer tables. Please
feel free to use them as templates for further work.
17. To speed up the starting up, have as few options in the .CFG
file as possible. Each option takes time to process.
18. Register your shareware copy. You get the latest version plus
a professional manual with much more in it.
19. If you use PC-Tools Desktop, turn off the macro facility
before using EasyEdit as a TSR. If you do not do this, you
will never be able to exit from EasyEdit once it is invoked.
@pa
@tc1Errors and what to do about them
Errors and what to do about them
--------------------------------
Possible errors:
1. If you open and close windows, the amount of free memory may
not agree with the total available for DOS commands. This is
because DOS needs contiguous memory whereas EasyEdit can use
non-contiguous memory.
The cure is to exit to DOS normally and then run the command
2. Normal EasyEdit errors should be self-explanatory.
3. If you get 'Runtime error ...' its an error I haven't trapped.
A common one is error 208 which means Easyedit can't find its
overlay file (EE.OVR). If so, please re-check the installation.
4. One word of warning: Do NOT invoke any TSR (Terminate and Stay
Resident) programs from the SHELL <SHIFT-F6> command. The
system may hang on you !!!!! TSR's are programs like MOUSE or
SIDEKICK. If you are not sure, ask someone.
If you get unexpected errors, please try and document them as best
as possible and contact me at the address above. I have tried to
make this as foolproof as I can but nothing is perfect.
When you register, you will get a supplementary manual with all
the EasyEdit errors and an explanation. Yet another good reason to
register.
With the use the the AUTOSAVE option and the automatic backups on
exit, your work should be safe.
@pa
@tc1Files included in the distribution
Files included in the distribution
----------------------------------
EE.EXE The program
EE.OVR The overlay file
EE.HLP The help file
EE.TXT Source text of the help file
EE.MCH Matching pairs file.
EE.PIF Program Information File for MS-Windows v3
EECFG.EXE Configuration program for environment
EEUNLOAD.EXE An unloader to the TSRed EasyEdit
KBD_INST.EXE Keyboard and help installation program
EEKEY.MAP Keyboard map file (text)
EEKEYF.ILE Keyboard map file (binary)
EE.CFG Data file - holds initialisation data
EEMOUSE.CFG Data file - for mouse setup
EEMEM.ABR Data file for memory abbreviations
EEFILE.ABR Data file for file abbreviations
COMMANDS.LST Easyedit command numbers.
*.MAC Keyboard macro files
*.PDF Printer Definition files
*.CHT Character translation files
*.FNT Font files
EASYMAN.TXT This manual - written with EasyEdit.
README.1ST A quick installation guide.
RELEASE.xxx Release notes for the current version.
RELNOTES.TXT Release notes for previous versions.
REGIST.FRM The registration form.
EE.DCT 80,000 word dictionary (registered
users only).
EE.IDX The index to the dictionary
@pa
@tc0Acknowledgements
Acknowledgements
----------------
Borland - without their Turbo Editor to get me started, this would
never have got off the ground. It's a shame it had a 'few' bugs in....
Max Brouwer for his dictionary routines.
Paul Medcalf, Chris Lodge and Dieter Heinzer - for giving me ideas
The entire DEC community - for 'hassling' me till I got it right.
Mitch Lichtenberg - for giving me the idea of including binary files
Steph - for being patient.
Enjoy it......
Alan Sharkey